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GENERAL EDITOR (EDT) 


Preface 


This manual is one of a series designed to instruct and guide the programmer in the use 
of the SPERRY UNIVAC Operating System/3 (OS/3). Specifically, this manual describes 
the OS/3 General Editor (EDT) and its effective use. Its intended audience is the novice 
user who has little knowledge in data processing, or the more experienced user who 
may or may not be familiar with EDT. 


This manual is divided into the following sections: 


Section 1. EDT Concepts 

Introduces you to the functions of EDT. 

Section 2. Using EDT 

Describes how to access, use, and terminate EDT. 

Section 3. EDT Commands 

Explains the purpose of the EDT commands and how to use them. 
Section 4. Command Modifiers 

Explains the purpose of the command modifiers and how to ig them. 
Section 5. EDT Procedure Files 


Explains the purpose and use of the EDT procedure files and the procedure file 
commands. 


Section 6. EDT Variables and Commands 


Explains the purpose of the EDT variables and how to define and use them. 
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Section 7. Directives 

Explains the purpose of the directives and how to use them. 

Section 8. Screen Commands 

Explains the purpose of the screen commands and how to use them. 

Section 9. Function Key Usage 

Explains the purpose and use of the function keys available to you in EDT. 
Section 10. Screen Mode Processing 

Explains the purpose and use of EDT screen mode and gives a sample session. 
Section 11. Error File Processing 


Explains the purpose and use of the error file processor and gives a sample 
session. 


Section 12. Error Detection and Recovery 

Describes the types of errors that may occur during an EDT session. 

Appendixes 

Lists the minimum abbreviations for the commands, command modifiers, directives, 
procedure file commands, and keywords. Also, summarizes the EDT commands, 


describes the EDT processing loop, explains the differences between EDT and Basic 
Editor Monitor Editor (BEM EDT), and provides sample EDT sessions. 


Other current OS/3 publications referenced in this manual that are helpful when using 
EDT are: 


System 80 Environment 


COBOL editor user guide/programmer reference, UP-9106. 
Describes the formats used to create COBOL source programs. 
Consolidated data management concepts and facilities, UP-8825 


Describes the organization and record formats of various file types. 
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Interactive services commands and facilities user guide/programmer reference, 
UP-8845 


Describes the commands and operating procedures for workstation terminals. 
Job control user guide, UP-8065 

Describes the job control language used under OS/3. 

RPG II editor user guide/programmer reference, UP-8803 

Describes the formats used to create RPG Il source programs. 

System service programs (SSP) user guide, UP-8841 

Describes various system utilities (e.g., librarian, linkage editor). 

System messages programmer/operator reference, UP-8076 

Describes the errors encountered when using OS/3. 

Spooling and job accounting concepts and facilities, UP-8869 


Describes basic spooling and job accounting concepts and options available to 
control spooling systems. 


Series 90 Environment 


COBOL editor user guide/pregrammer reference, UP-9106 
Describes the formats used to create COBOL source programs. 
Consolidated data management concepts and facilities, UP-8825 
Describes the organization and record formats of various file types. 


Interactive services commands and facilities user guide/programmer reference, 
UP-8845 


Describes the commands and operating procedures for the workstation terminals. 
Job control user guide, UP-8065 


Describes the job control language used under OS/3. 
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= RPG Il editor user guide/programmer reference, UP-8803 
Describes the formats used to create RPG Il source programs. 
m System service programs (SSP) user guide, UP-8062 
Describes various system utilities (e.g., librarian, linkage editor). 
m System messages programmer/operator reference, UP-8076 
Describes the errors encountered when using OS/3. 
B Spooling and job accounting concepts and facilities, UP-8869 


Describes basic spooling and job accounting concepts and options available to 
control spooling systems. 
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1. Introduction 


1.1. WHAT IS EDT? 


The SPERRY UNIVAC OS/3 General Editor, commonly known as EDT, is a user-oriented 
interactive program that enables you to create and update library modules and data files 
from a workstation. With EDT, you can interactively create and update your source 
programs, job control streams, and data files. You can also copy and concatenate files. 


EDT supports three subprocessors: a COBOL subeditor, an RPG Il subeditor, and an 
error file processor. 


The language subeditors allow you to create and update COBOL or RPG II source 
programs interactively at your workstation using screens, and they provide immediate 
syntax checking. For more information on them, see either the COBOL editor user 
guide/programmer reference or the RPG II editor user guide/programmer reference. 


The error file processor lets you see and correct errors in COBOL, RPG Il, and 
FORTRAN IV source code immediately after compilation, without waiting for your 
language compiler to print its error listing. For more information on the error file 
processor, see Section 11 of this manual. 


NOTE: 


As part of its operation, EDT uses the screen format file $Y$FMT. Therefore, whenever 
you're using EDT, you cannot update $Y$FMT using the MIRAM librarian (MLIB) 
because MLIB needs exclusive use of $Y$FMT for that operation. 


1.2. HOW EDT OPERATES 


You create and update files (via EDT) in a temporary MIRAM disk file known as the EDT 
work-space file. The work-space file is automatically created each time EDT is activated 
and lasts for the duration of the EDT session. 


When you create a file, you enter data or statements into the work-space file as shown 
in Figure 1-1. When all entries are made, you can then save a copy of the work-space 
file by writing it to a permanent file, listing it on the printer, or punching it on cards. 
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ENTER STATEMENTS OR 
DATA INTO WORK-SPACE 
FILE 


EDT 


' SAVE COPY OF 
WORK-SPACE FILE 


SAVE COPY OF 


WORK-SPACE FILE EDT 
WORK-SPACE 


FILE 










WRITE TO 
PERMANENT FILE 


LIST ON PUNCH ON 
PRINTER CARDS 
CARDS 
PRINTER 
DISKETTE 


DISK 


Figure 1—1. Creating a Library Module or Data File via EDT 
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_ When you update an existing file, a copy of that file is placed in the work-space file 
(Figure 1-2). The original version of your file remains unchanged as a backup copy with 
all updating being done in the work-space file. Once you finish updating your 
work-space file, you can write a copy of it to the original file (overwriting the original 
version) or write it to a new file. You can also list it on the printer or punch it on cards. 











RETRIEVE COPY PLACE COPY OF FILE 
OF FILE INTO WORK-SPACE FILE 
EDT 
PY OF 
ee =a SAVE COPY OF WORK- 
(OVERWRITE ORIGINAL SPACE FILE (UPDATED 
FILE) FILE) 


SAVE COPY OF = 
ORIGINAL WORK-SPACE FILE E 


@ FILE WORK-SPACE 







FILE 


WRITE TO 
NEW FILE 


LIST ON PUNCH ON 
PRINTER CARDS 
CARDS 
PRINTER 
DISKETTE 


DISK 


Figure 1—2. Updating a Library Module or Data File via EDT 
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During an EDT session, EDT assigns temporary work-space line numbers to data or — 


statements entered in the work-space file. Each entry made to the work-space file is 
assigned its own unique line number; by using these line numbers you can reference 
and manipulate the data and statements in your file. The line numbers are 8-digit 
numbers with leading zeros suppressed. For example, a number such as 0001.2345 
would be displayed as 1.2345. Note that a decimal point is used in the line number for 
convenience. Work-space line numbers are automatically generated and displayed by 
EDT. 


When using EDT, you can operate in one of two modes: line mode or screen mode. 
The following subsections describe both of these modes and help give you an idea of 
which mode is more suited to your applications. Unless you specify screen mode, EDT 
automatically operates in line mode. You specify screen mode by using the EDT 
directive @SET, which we describe in Section 7. 


1.2.1. Line Mode 


In line mode, EDT lets you enter source code or data one line at a time. After 
completing the line, you press the XMIT key to pass the line to the EDT work-space 
file. If you have only a few lines of source code to enter, line mode would be the 
quickest and easiest way to enter them. As you key in lines, you're unable to move the 
cursor back up to change those lines and you can see only 24 lines at a time on your 
screen. 


In line mode, you can use all the EDT commands. If you're operating in line mode when 
you enter a command, EDT returns you to line mode after it processes the command. 


The following is an example of a typical line mode screen: 


ED@@@ EDITOR VERSION XX.X READY 


$000 data line 
000 data line 
@600 data line 
0669 data line 
@000 data line 
@00@ data Line 
0660 data Line 
$000 data Line 
$000 data line 
- $000 data Line 
. 0600 data Line 
- 0000 data line 
- 0006 data line 
- 0900 data line 
- $000 data line 
- $000 data line 
. 000 data line 
. 690¢ data tine 
. $606 data Line 
. 60@@ data Line 
- 696 data line 
. $600 data Line 
. $0900 data line 


on Ow & WN = 
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1.2.2. Screen Mode 


In screen mode, EDT lets you enter up to 14 lines of source code or data at one time. 
Again, you press the XMIT key to pass the lines to the EDT work space. However, 
depending on whether you want to enter single or multiple lines in one transmission, 
either : (1) EDT displays the single lines you key in as you transmit them to the EDT 
work space and scrolls the single lines up as it fills the screen; or (2) you enter up to 
14 lines at a time before you transmit them. In these ways, EDT screen mode makes it 
easier for you to enter source code or data. 


Another advantage to using screen mode is that EDT provides formatted screens for 
entering source code or data. In screen mode, you can enter source code using supplied 
COBOL, RPG Il, or FORTRAN IV screens. These screens identify the programming fields. 
In addition, EDT provides a freeform screen that you can design to accept uniform data. 
For example, you can create a name and address file showing the appropriate fields or 
you can create an ASSEMBLER coding form. 


lf you are a COBOL or RPG I! programmer, you may have used or considered using the 
EDT subeditors (the COBOL editor or the RPG Il editor) for creating and updating your 
source code. If your updates are not extensive and you don't need the syntax checking 
provided by those editors, yeu can use screen mode to quickly make updates and 
changes. 


You activate EDT screen mode using the @SET directive described in Section 7. For a 
complete description of screen mode processing, see Section 10. Once in screen mode, 
you can use all the EDT commands except the UPDATE command. If you're operating 
in screen mode when you enter a command, EDT returns you to screen mode after it 
processes the command. 


The following is a sample screen-mode screen. This screen helps you enter COBOL 


source code: 


OS/3 EDT (V8.@ ) EDT COBOL SINGLE TRUNCATE 


KKK HH KK KK KK KKK KK KKK KK KKK KKK KIER KEE KEKE KEKE EKER EEE EERE EEEREEKEKKKKKEKRK 


LINE # SEQUENCE CONTINUATION TXTA 


EDT COMMAND: 
errr rrr rr rTt rrr rrrrrrrrrrrerrretreerer rer rere PPT Perr PTET eS ee eT eS 


ERROR MESSAGE AREA (2 lines) 
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1.3. COMMAND CONVENTIONS AND TERMS 


This is a list of conventions that you must follow when formatting EDT commands: 


All commands must begin with the current command trigger, which is preset to an 
at sign (@): 


@PRINT 


All commands keyed in as data lines must begin with a double command trigger: 


@@DELETE 


Commands, command modifiers, and parameters in capital letters must be keyed in 
exactly as shown: 


@LIST 


Underscoring part of a command, command modifier, parameter, or keyword 
indicates that it may be abbreviated; you need to enter only the underscored 
portion. However, you may enter the entire command and it will execute properly. 
When a command, command modifier, parameter, or keyword is not underscored, 
you must enter the entire word. In the following example, PU of the PUNCH 
command is underscored. You must enter at least PU for the command to execute; 
but you may enter PUN, PUNC, or PUNCH and the command will execute properly. 


@PUNCH 
Parameters constructed in lowercase letters designate user-defined variables: 


@FIND 'search-string' 


Information contained within brackets represents optional entries that are included 
or omitted (depending upon command requirements): 


@NOP [ comment] 


Alternate choices for a parameter, when at least one choice is required, are 
enclosed in braces: 


@GOTO a 
Line 


Commas, periods, colons, semicolons, equal signs, and parentheses must be keyed 
in exactly as shown: 


@SET LINE=lLength 
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A shaded parameter indicates that this parameter is the default: 





This is a list of terms that represent variable information you supply when structuring 
your commands: | | 





change-string 


Specifies a character string (1 to 50 characters) enclosed in apostrophes or a 
hexadecimal string enclosed in apostrophes and preceded by an X. 


column-range 


Specifies columns in the work-space file with column numbers, the special symbols 
[ and ], or EDT variables. Special symbols or EDT variables can be used only if they 
are assigned appropriate values. A_ single column, nonconsecutive columns, 
consecutive columns, or a combination of columns may _ be = specified. 
Nonconsecutive columns are separated by commas (1,5,7) and consecutive 
columns are specified by the first and last columns separated by a colon (5:10). 
Columns must be specified in ascending order. 


destination 


Specifies bya line number or multiple line numbers the line location where lines are 
copied (via the COPY command) or moved (via the MOVE command). 


increment 


Defines a 1- to 9-digit decimal number used as the increment in the SEQUENCE and 
NUMBER commands. 


label 

Defines a symbolic name of a command line. A label can consist of one to seven 
alphanumeric characters, but the first must be alphabetic. A label can be defined in 
any EDT command or in any EDT procedure file command. It must be enclosed in 
parentheses and immediately follow the @ sign to be valid. It cannot contain 
embedded spaces. For example, (XYZ) is the label in this command line: 


7.0000 @(XYZ) PRINT 10:20 


NOTE: 


When the label ts specified in the GOTO command, parentheses should not be 
used: GOTO XYZ | 
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line-range 


Specifies by work-space line numbers, special symbols % * $ & and ? (if they have 
appropriate values) and EDT variables (if they have appropriate values), lines in the 
work-space file. A single line, nonconsecutive lines, consecutive lines, or any 
combination of these lines may be specified. Nonconsecutive lines are separated by 
commas (3,8,11) and consecutive lines are specified by the first and last lines 
separated by a colon (*:30). Lines must be specified in ascending order. 


search-string 


Defines a character string or a hexadecimal string that you want EDT to search for. 
The character string (of 1 to 50 characters) must be enclosed in apostrophes (‘) or 
quotes('). The hexadecimal string must be enclosed in apostrophes and be 
preceded by an X. When apostrophes are used, any occurrence of the specified 
string is searched for. When quotes are used (at the beginning, end, or at both 
ends of the string), only those strings bound by delimiters where the quotes appear 
are searched for. EDT considers the following characters to be text string 
delimiters:. (+) ! ; - / , ? : = " *° or a space. 


If the search string itself contains quotes or apostrophes, you must specify both 
the quotes or apostrophes in the string and the quotes or apostrophes that delimit 
the string. For example, if the search string is ‘xyz’, you must specify the search 
string as ‘xyz’ so EDT can access it correctly. 


The following examples explain the difference between the use of apostrophes and 
quotes with a search string. 


'ABC' Searches for any occurrence of ABC 

“ABC! Searches for occurrences of ABC with a delimiter in front of 
A: /ABC 

'ABC” Searches for occurrences of ABC with a delimiter immediately 


after the C: ABC? 


“ABC” Searches for occurrences of ABC with delimiters on both ends: 
*ABC* 


sequence-string 


Specifies an alphanumeric character string that EDT uses for sequencing (or 
ordering). The sequence string must be enclosed in apostrophes and at least one of 
its rightmost characters must be an integer from O to 9. A sequence string of up 
to 15 characters may be specified. Only the numeric characters on the right end of 
the sequence string are incremented, and all alphabetic characters to the left of the 
rightmost alphabetic character (including that character) are not changed. 
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# string 


Specifies a character string (of 1 to 50 characters) enclosed in apostrophes or a 
hexadecimal string enclosed in apostrophes preceded by an X. 


# special symbols 


Defines characters that represent a present line range or column range in the 
work-space file. 


% Represents the line number of the lowest line in the current 
work-space file. 


$ Represents the line number of the highest line in the current 
work-space file. 


Represents the line number of the current line in the work-space file. 


& Represents all lines in the work-space file (i.e., the entire work-space 
file). The line range for & is preset to .0001:9999. 


? Represents the line number of the first line containing the most 
recently specified search string. EDT assigns this special symbol 
when you do an @ FIND command. 


[ Represents the column number where the most recently found search 
string begins. EDT assigns this special symbol when you do an @ 
FIND command. 


| Represents the column number where the most recently found search 
string ends. EDT assigns this special symbol when you do an @ FIND 
command. 


™ = command help screens 


EDT provides help screens for all the commands (meaning the EDT commands, 
modifiers, directives, procedure file commands, variables, and screen commands) 
presented in this manual. To see these help screens, you use the @PROMPT screen 
command described in Section 8. These help screens give a short description of 
each command, along with its format. In this manual, we present the format for 
each command, as well as the format that the help screen displays for that 
command if you request It. 


You should note that the formats presented in this manual and those you see on 
your screen differ slightly. These differences exist because the workstation screen 
(or one of the display devices that supports EDT) cannot display all the characters 
used in the formats in this manual. Although the syntax appears to be different, 
you should specify the EDT commands according to the conventions we present in 
the preceding paragraphs. For a list of the differences in conventions, see the 
explanation for the @PROMPT screen command in Section 8. 
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2. Using EDT 


2.1. HOW TO ACCESS EDT 


You can access EDT interactively* via a workstation, the System 80 console 
workstation, Or a remote communications terminal that uses interactive services. When 
using the editor on a remote communications terminal that uses interactive services, be 
sure to use the field-protect feature on the terminal. Otherwise, you'll encounter errors. 


If you're accessing EDT via a workstation (and you're the first user), turn on the 
workstation and log on. (You can follow the logon procedure described in the 
interactive services commands and facilities user guide/programmer reference.) After 
you've successfully logged on, press the FUNCTION key and (while holding it down) 
press the SYS MODE key. Then key in EDT (and optionally the first input line to EDT) 
and transmit (press the XMIT key). EDT is now activated. —_ 


To access EDT via the System 80 console workstation, you press the FUNCTION key 
and WS MODE key at the same time and then transmit. Next, log on (again using the 
logon procedure described in the interactive services commands and facilities user 
guide/programmer reference). After you've successfully logged on, press the FUNCTION 
and SYS MODE keys at the same time. Then key in EDT (and optionally the first input 
line to EDT) and transmit. EDT is activated. When working at the console workstation, 
use EDT in workstation mode because the workstation screen is easier to use in that 
mode than in console mode. 





teenth Sana AT LTE EE  R NN AER AE 


*EDT can also be used in batch mode. See 2.4 for more details. 
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When ELT is succes fully activated, ** clears the workstation and displays the message 
EDITOR VERSION XX.X RE,ADY on ti bottom of the scree i. (The XX.X stands for the 
EDT version number that you’re using. You can refer to it whenever discussing EDT 
with a Sperry Univac representative.) In addition, EDT sets the current work-space line 
to 1.0000 and displays the first line followed by a start-of-entry symbol ([>) on the next 
line of the screen. The work-space line number (OO00.0000) and the start-of-entry 
symbol take up 10 columns on the screen but not in EDT’s work space. So column 11 
on the system state line equals column 1 of your data record. 


ED@0@ EDITOR VERSION XX.X READY 
1.9000 > 





























You may begin an EDT session by keying in either a data line (data or a statement) or 
an EDT command on line 1. After the line is keyed in, you must press the XMIT key to 
pass the line to the EDT work-space file. (This is true for all lines keyed in at the 
workstation during an EDT session.) If the line you key in is a data line (a line without a 
command trigger (@) or a line preceded by a double command trigger (@@)), the next 
line number displayed on the workstation screen is 2.0000. (At the beginning of an EDT 
session, the increment for the work-space line numbers ts automatically set to 1.) 








ED@@® EDITOR VERSION XX.X READY 
1.9@0@>DATA LINE 
2.9900L> 
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lf the line you key in is a command preceded by a single command trigger (@), the next 
line number displayed is the same as the previous one. Therefore, if a command is 
keyed in on line 2.0000, the next line number displayed is 2.0000. There are; however, 
two exceptions to this: (1) if an @ command is entered to change the current line 
number (see 3.2), or (2) if a COPY or MOVE command is entered that transfers lines to 
new line locations beyond the highest line in the current work-space file. For example, if 
the highest line in the current work-space file is 75 and the command @MOVE 10 TO 
100 is entered on line 2, the current work-space line number is automatically reset to 
101, not 76. The destination (100) is determined by the increment, which is explicitly or 
implicitly specified in the destination (1), making the new line number 101. (See the 
COPY command (3.4) and MOVE command (3.10).) 








ED@@@ EDITOR VERSION XX.X READY 
1.9000>DATA LINE 
2.0000>@DELETE 1 
2.0000> 


When entering EDT commands or data lines that are longer than one line (80 characters 
shown on the system state line) on the workstation screen, you do not have to indicate 
continuation at the end of the first line. EDT automatically moves the cursor to the 
beginning of the next line so you can enter the rest of your command or data line and 
transmit it to EDT’s work space. However, some OS/3 products, such as job control, 
require an X in column 72 of the first line to show that a data record continues on the 
next line. In these cases, you must remember that column 11 on the system state line 
equals column 1 of your data record; so column 80 on the system state line equals only 
column 69 of your data record. Therefore, place the X for continuation in column 3 of 
the second line on EDT’s screen. To get to column 3 of the second line, either press 
the space bar enough times to get the cursor there or set a tab at column 72 using the 
(@SET directive (see Section 7). But don't transmit the line until you enter an X in 
column 3 of the second line. Then EDT will display the next line number to accept the 
rest of the data record. 
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For example, if you were keying in a // LCB job control statement that was too long to 
fit on one line, you would key it in on three consecutive lines, pressing XMIT after each 
one, like this: 


ED@@@ EDITOR VERSION XX.X READY 
1.0000>// LCB C'/.4+*",X'7@' ,C'4+,$!')(-0123456789ABCOEFGHI JKLMNOPQRSTUVWXYZ', 
Xx 
2.9000> NUMBCHAR=48, CARTID=X'@2', TYPE=0770,DUAL=C'*/''>+<', 
X 
35 .90000> CARTNAME=SCIENCE 


4 .0000r 
COLUMN: 11 : 
A a 








The rest of the EDT session contiriues in the same manner. A complete sample of an 
EDT session is provided in the following subsection. 


During every EDT session, there are six types of commands you can enter. They are: 
s EDT commands 

Let you create and update your files 
a = =Modifier commands 

Enhance or restrict the performance of the EDT commands 
w Procedure file commands 

Let you divide the EDT work-space file into a maximum of 10 subfiles 
= Variable commands 

Hold values that give flexibility in structuring commands 
m Directive commands 

Serve as the interface between you, EDT, and your operating system 
= Screen commands 

Display screens that make EDT easier to use 


Sections 3 through 8 describe each type of command in detail. 
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2.2. SAMPLE EDT LINE MODE SESSION 


This sample EDT line mode session will give you a general idea of what an EDT session 
is and how it works. Since your knowledge of EDT may be limited, much of what is 
presented here may not be clear. It is only to serve as a base for what you will learn in 
the following sections. 


Once you read through this manual it will be helpful to come back and examine this 
sample EDT session once again. It will then be clearer to you, and you can use it as a 
guide in your own EDT sessions. 


To see this same program updated in a screen mode session, see Appendix G, where 
we present more sample EDT sessions. 


This EDT session is an update of an existing COBOL source program. The existing 
program prints address labels for magazines like this: 


NAME 


ADDRESS 
CITY STATE ZIP 





By using EDT, we will update that program to double-space the lines and include an 
account number next to the name like this: 


NAME 


ADDRESS 


CITY STATE ZIP 





We will begin this session by transferring a copy of the program LABELS into the EDT 
work-space file from the program library MAGAZINE on disk volume USERO1. We will 
then update it, using the available EDT facilities. The session will end when we return a 
copy of the work-space file (the program LABELS) to the library. The old version of the 
program LABELS will be replaced by the updated version. 
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SAMPLE EDT LINE MODE SESSION 


Transfers our source program 1.@0@@PQOREAD MO=LABELS, FIL=MAGAZINE, VSN=USERO1 
into the work-space file 

Displays the contents of 51.000OPaPRINT & 

the work-space file {our 

source program) on the 

workstation screen 


1.0000> IDENTIFICATION DIVISION. 
2.9000> = PROGRAM-ID. LABELS. 
3.0000r ENVIRONMENT DIVISION. 
4.0000> CONFIGURATION SECTION. 
5 .0000> SOURCE - COMPUTER .UNIVAC -0S3. 
6. 0000> OBJECT - COMPUTER.UNIVAC-0S3. 
7 .0000> INPUT-OUTPUT SECTION. 
8. 0000> FILE CONTROL. 
9.9000> SELECT CARDIN, ASSIGN TO CARD READER-CARDIN-F. 
10.9000> SELECT PRINTOUT, ASSIGN TO PRINTER-PRINTOUT-F. 
11.0000> DATA DIVISION. 
12.0000r FILE SECTION. 
13.0000> FD CARDIN | 
14. 0000> LABEL RECORDS ARE OMITTED. 
15. 9000> @1 CARD-INPUT. 
16. 0000> 02 NAME PIC X(25). 
17 .0000> @2 STREET PIC X(25). 
18.0000> @2 CITY PIC X(15). 
19. 0000> @2 STATE PIC X(2). 
20.0000> @2 ZIP PIC X(5). 
21.0000> @2 FILLER PIC X(8). 
22 .0000> FD PRINTOUT 
23. 9000r LABEL RECORDS ARE STANDARD. 
24.0900> 91 PRINTLINE PIC X(29). 
Our source program 25 .0000r> WORKING-STORAGE SECTION. 
displayed 26.0000> @1 CITY-STATE-ZIP-LINE. 
27. 0000> @2 CITY-OUT PIC X(15). 
28. 0000> @2 FILLER PIC X(1) VALUE SPACES. 
29 .0000> @2 STATE-OUT PIC X(2). 
30.0000> @2 FILLER PIC X(2) VALUE SPACES. 
31.0000> @2 ZIP-OUT PIC X(5). 
32.9000> PROCEDURE DIVISION. 
33.9000> BEGIN- JOB. 
34.0000> OPEN INPUT CARDIN, OUTPUT PRINTOUT. 
35 .0000> READ-CARD. 
36.9000> READ CARDIN, AT END GO TO END-OF-JOB. 
37. 0000> MOVE SPACES TO PRINTLINE. 
38 .0000> WRITE PRINTLINE. 
39. 0000> MOVE NAME TO PRINTLINE. 
40. 0000> WRITE PRINTLINE. 
41.0000> MOVE STREET TO PRINTLINE. 
42 .0000r WRITE PRINTLINE. 
43 .0000> MOVE CITY TO CITY-OUT. 
44 .0000> MOVE STATE TO STATE-OUT. 
45 .0000> MOVE ZIP TO ZIP-OUT. 
46 .0000> WRITE PRINTLINE FROM CITY-STATE-ZIP-LINE. 
47 .0000> GO TO READ-CARD. 
48 .9000> END-OF- JOB. 
49 .0000> CLOSE CARDIN, PRINTOUT. 
50. 0000> STOP RUN. 


(continued) 
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New line to program keyed 
in at the workstation 


Moves the contents of line 
51 to line 16.5 

Changes the ‘8° on line 21 
to 4’ 

New line to program keyed 


in at the workstation 


Moves the contents of line 
52 to line 39.5 


New lines to program bowed 


in at the workstation 


Copies the contents of line 
53 to lines 40.2, 42.2 and 
46.2 


Deletes line 53 


Copies the contents of fine 
54 to lines 40.4, 42.4 and 
46.4 


Deletes tine 54 


Displays lines 12 through 


31 of our work-space file 


New tine added 


Change made to existing line 


Displays lines 39-48 
of work-space file 
New line added 


New line added 
New line added 


New line added 


New Ine added 


51 


52. 


52. 


52. 


95. 


33 


54. 


55 


35 


55 


12. 
13. 


14 


15. 
16. 
16. 
17. 
18. 
19. 
20. 


21 


22. 
Zo 
24, 
25. 
26. 
27. 
28. 
29. 
30. 


31 
55 


39. 
39. 
4Q. 
40. 
40. 


41 
42 


42. 
42. 
43. 


44 
45 


. 900O> 
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@2 ACCT-NO PIC X(4). 
OOGO>aMOVE 51 TO 16.5 

@0@@>90N 21 CHANGE '8' to ‘4' 
O000> MOVE ACCT-NO TO PRINTLINE. 


OO0@>aM0VE 52 TO 39.5 


- O000r MOVE SPACES TO PRINTLINE. 
0000r WRITE PRINTLINE. 
.@08@raCOPY 53 TO 40.2, 42.2, 46.2 


-O9OOOPQDELETE 53 
55. 


@OOOPACOPY 54 TO 40.4, 42.4, 46.4 


.OOOOPaDELETE 54 
55. 


OOOOPOPRINT 12:31 


OO00r FILE SECTION. 

0000r FD CARDIN 

. 9O60> LABEL RECORDS ARE OMITTED. 
OOO0> @1 CARD-INPUT. 

8O000> @2 NAME PIC X(25). 
5000> @2 ACCT-NO PIC X(4). 
0000> @2 STREET PIC X(25). 
0000> | @2 CITY PIC X(15). 
0000> @2 STATE PIC X(2). 
O000> @2 ZIP PIC X(5). 

- 0600> @2 FILLER PIC X(4). 
0O00> FD PRINTOUT 

O000r LABEL RECORDS ARE STANDARD. 
OO00> @1 PRINTLINE PIC X(29). 
0000> WORKING-STORAGE SECTION. 

9O0Or @1 CITY-STATE-ZIP-LINE. 

0000r @2 CITY-OUT PIC X¢€15).. 
OO00> @2 FILLER PIC X(1) VALUE SPACES. 
OOOOr @2 STATE-OUT PIC X(2). 
0000r @2 FILLER PIC X(2) VALUE SPACES. 
. 8000> @2 ZIP-OUT PIC X(5). 
.O9O9OPAaPRINT 39:48 


0000> MOVE NAME TO PRINTLINE. 
5000> MOVE ACCT-NO TO PRINTLINE. 
0O0Or WRITE PRINTLINE. 

2000r> MOVE SPACES TO PRINTLINE. 
4000> WRITE PRINTLINE. 

. 0900> MOVE STREET TO PRINTLINE. 
- 900O> WRITE PRINTLINE. 

2O0Or MOVE SPACES TO PRINTLINE. 
4000> WRITE PRINTLINE. 

O00O> MOVE CITY TO CITY-OUT. 

- 0000> MOVE STATE TO STATE-OUT. 
- 00OO> MOVE ZIP TO ZIP-OUT. 


(continued) 
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46 .9000r WRITE PRINTLINE FROM CITY-STATE-ZIP- 
LINE. 
New line added 46.29000> MOVE SPACES TO PRINTLINE. 
New line added 46 .400@r> WRITE PRINTLINE. 
47 .400@> GO TO READ-CARD. 
48.0000> END-OF -JOB. 
Lists the contents of the 55.000@PaLIST & 
work-space file (our entire 
program) 
Punches lines 12 through 45 55.@@0@>@PUNCH 12:45 
on cards 
Writes our program to a 595.900@>QWRITE MO=LABELS,FIL=MAGAZINE, VSN=USER®O1 


permanent file on disk 


Reminds us that this module IS1@@ FILE/MODULE ALREADY EXISTS; 
already exists, and asks if OK TO WRITE TO IT? (Y,N) Y 

we want to overwrite it 

We select Y, causing the 

previous version of our program 

to be overwritten 


2.3. HOW TO TERMINATE EDT 


To terminate EDT, key in @HALT and then transmit (press the XMIT key). This returns 
you to an idle workstation mode from which you can enter system mode to issue 
another interactive services command. 


35.0000 @HALT 








lf you want to temporarily leave EDT (and return to system mode), key in @SYSTEM 
instead of @HALT. When you are ready to return to EDT, key in RESUME (in system 
mode). 
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2.4. USING EDT IN A BATCH ENVIRONMENT 


Even though EDT is an interactive product, it is important to note that you can also run 
your EDT session as a batch utility. For example, if you wanted to make a change 
throughout your whole work-space to a source program using EDT but you didnt have 
a workstation immediately available, you could make the change by running the EDT 
session as a batch utility. From LOGON to LOGOFF you enter on cards exactly what you 
would key in at the workstation during an interactive EDT session (as in Figure 2-1). 
Note that you must include a // FILEID card in front of the card input and a // FIN card 
at the end of the card input when running EDT as a batch utility. Both the // FILEID 
card and // FIN card are described in the job control user guide. 


NOTE: 


You may run any previously stored EDT session as a batch utility by simply issuing the 
appropriate ENTER command from the system console. 


@HALT 1L 
@D ‘PAID’ ; 


@R FIL=ACCT,VSN= 
RELO70 













// FILEID=DATAFILE 


Figure 2-1. Batch EDT Session 


Next, you store this routine (the card input) as a file on either the spool file via the 
INPUT reader command (which is described in the spooling and job accounting concepts 
and facilities manual) or on a library via the librarian’s ELE command (which is discussed 
in the system service programs user guide). 


After the routine is stored, you can run it by issuing the appropriate ENTER command 
from the system console. (The ENTER command is described in the interactive services 
commands and facilities user guide/programmer reference.) 
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3. EDT Commands 


3.1. INTRODUCTION 


EDT provides you with a special set of commands to create and update your files. With 
these commands you can manipulate anything in your files. You can add new 
information to your files, delete wrong or obsolete information from your files, or 
modify the existing contents of your files, from a single character up to the entire file. 


You enter these commands from a workstation. You can enter them individually, or 
combine them with other commands to permit faster and more efficient editing. 
However, no matter which way you choose, you must always start each command line 
with the current command trigger (which is set to @ (an at sign) at the start of each 
new EDT session). 


The following subsections explain the EDT commands. The commands are presented in 
an alphabetic sequence for easy reference. Each subsection contains the description, 
format, and some typical examples of a particular EDT command. For your convenience, 
the EDT commands are summarized in Table 3-1. 


In line mode, you can use all the EDT commands. In screen mode, you can use ail the 
EDT commands except the UPDATE command. No matter which mode you're in when 
you issue an EDT command, EDT returns you to that mode after it processes the 
command. 
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Table 3-1. EDT Commands 


commons [amt 


Sets the current line number and increment for data lines keyed in at the workstation. 
CHANGE Replaces an existing string in the current work-space file. 


COPY Copies lines in the current work-space file to new line locations without deleting the original 
lines. 


DELETE Erases specified lines from the current work-space file. 


FIND Locates the first occurrence of a string in the work-space file and assigns its corresponding line 
number to the variable ? and the column numbers of the first and last columns it occupies to [ 





and |] respectively. 





FSTATUS Creates in the current work-space file a list of all modules contained in a specified program 
library. 
INSERT Inserts a specified string into lines in the current work-space file. 


LIST Lists specified lines from the current work-space file on the printer. 


MOVE Transfers specified lines to new line locations in the current work-space file and deletes the 





original lines and line numbers. 


NUMBER Inserts Sequence numbers into input lines. 
PRINT Displays specified lines from the current work-space file on the workstation screen. 


PUNCH Reproduces specified lines from the current work-space file on cards. 


READ 


Reads a copy of either a program library or data file residing on disk, diskette, tape, or cards 


into the work-space file. 


REMOVE Deletes a specified string from lines in the current work-space file. 
SEQUENCE Places sequence numbers in existing lines in the current work-space file. 
UPDATE Displays specified lines from the current work-space file one at a time for you to edit or change. 


WRITE 


Writes a copy of the current work-space file to a program library or data file on disk, diskette, 


or tape, or to the spool file. 
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3.2. SETTING THE LINE NUMBER (@) 


The @ command sets the current line number and increment for the data lines keyed in 
at the workstation. 


The format is: 


@{line-number[ (incr)] iy jose 
+ command 


The help screen format is: 


SYNTAX1: @<LINE-NUMBER>[<INCR>][2<DATA>/<COMMAND> ] 
SYNTAX2: @+[:<DATA>/<COMMAND> ] 


SYNTAX3S: @-[:<DATA>/<COMMAND> ] 





where: 


Line-number 
Implicitly sets the current work-space line number to any number ranging from 
.0001 to 9999.9999. The current increment is implicitly set to 1, 0.1, 0.01, 
0.001, or 0.0001, depending on the decimal location of the least significant 
digit specified in the line number. 


ner 
Explicitly sets the current increment for subsequent line numbers. It is written 
in the form of nnnn.nnnn decimal digits. Leading and trailing zeros are optional 
but the parentheses are required. No space may exist between the line number 
and increment. If the incr parameter is omitted, the line number implicitly sets 
the increment. 


Causes EDT to access the current line plus the current increment in the 
work-space file. 


Causes EDT to access the current line minus the current increment in the 
work-space file. 
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data 
Indicates data (text) that is being keyed in at the workstation. 


command 
Indicates commands that are being keyed in at the workstation. 


NOTES: 

1. If the current line number is incremented to 9999.0000 or greater by EDT, the 
current increment is automatically reset to 0.0001. This prevents the user from 
creating lines with line numbers greater than 9999.9999. 


2. The increment and line number pertain only to the current work-space file. 


3. If the line number is set to an already existing line, that line becomes the current 
line. If you enter anything on that line, EDT overwrites the old line. 


Some typical examples of the @ command are: 


5.900@rdata Line 
6.99000rdata line 


7.9090@rdata Line 
8.900Oraz2.5 
2.5000r 





Here, the @2.5 command on line 8 sets the line number to 2.5000 and displays 
the line number on the next line. (Note that EDT doesn’t display the contents of 
that line.) 


.9900ra25 
.9000rdata Line 
.900@rdata Line 


.9900rdata line 
.990Ora+ 
. 0O9OOr> 





Here, the @+ command on line 28 displays the next line number (29) on the 
following line, which is ready to accept data or a command. 
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6S You can also key in data or commands as part of the @+ command as shown in the 
next example. 


1.9000rdata Line 
2.0090>data line 


3.90000rdata line 
4.0000ra+:DATA USED WITH THIS COMMAND. 
6.9000rP 





Here, the @+ command on line 4 assigns the data keyed in with it to the next line 
number (5.0000). Notice that this line (5.0000) is not displayed, but the next line 
number following it (6.0000) is displayed. You can then key in data or a command. 


300.0000>data Line 
301.90090rdata line 
& 302.0000>data Line 
303. 0000>a- 
302.0000> 





Here, the @- command on line 303 decreased the current line number by the | 
current increment. The previous line number is displayed for you to key in data or a 
command. You can also key in data and commands with the @- command. The 
data is placed on the previous line and then the current line number is redisplayed 
for you to key in data or a command. Note that any data located on the previous 
line at the time the @- command is issued is overwritten. 


The following table shows how the increment for work-space line numbers is 
automatically or explicitly set via the @ command. 









Line number Increment 
set to set to 


Command 


@312.05 312.05 


@10.0060 | 10.0060 0.0001 
@4(.05)* 4.00 0.05 


*Sets the increment explicitly to 0.05. 
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3.3. CHANGING DATA (@CHANGE) 

The CHANGE command permits the changing of data on one or more lines in the 
work-space file. It replaces an existing string (search string) with a new string (change 
string). If the new string is not the same length as the previous one, the line is either 
increased or decreased. 

The format is: 


@CHKANGE [ 'search-string'[ *n]] TO ‘'change-string'[ «n] 


The help screen format is: 


SYNTAX:@C [HANGE] [<SEARCH-STRING>]TO <CHANGE-STRING> 





where: 


'search-string' 

Specifies a string in the current work-space file to be replaced. The search 
string is usually enclosed in apostrophes; however, it may also be enclosed in 
quotes or a combination of quotes and apostrophes. If no search string is 
specified, the change is performed as though the search string consisted of 
EXCLUDE characters the same length as the change string. Multiple copies of 
the search string may be specified by using the string multiplication factor «n, 
where n is the number of times the search string is multiplied. After 
multiplication, the product of the number of characters in the string being 
multiplied and the string multiplication factor can't exceed 50. 


'change-string' | 
Specifies a string to be inserted in place of the search string in the current 
work-space file. The change string must be enclosed in apostrophes. Multiple 
copies of the change string may be specified by using the string multiplication 
factor «n, where n is the number of times the change string is multiplied. After 
multiplication, the product of the number of characters in the string being 
multiplied and the string multiplication factor can’t exceed 50. 
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@ Some typical CHANGE command examples are: 


@C ‘BOB’ TO ‘ROBERT’ 


Changes the first occurrence of BOB on every line in the current work-space file to ROBERT. If BOB appears more 
than once on a line, the remaining occurrences are not changed. 


@C TO ‘ROBERT’ 


Changes the first six columns of every line in the current work-space file to ROBERT 


@C °."#10 TO *."*5 
Changes the first occurrence of .......... (a separator between data fields, for example) to ....., thereby making room 
on every line in the current work-space file for another 5-character data field. 


The following command modifiers can be added to the CHANGE command, increasing 
its capability: ALL, COLUMN, FIRST, and ON. 


Commands that can be combined with the CHANGE command that permit faster and 
more efficient editing are: COPY, DELETE, FIND, FSTATUS, LIST, MOVE, PRINT, 
PUNCH, READ, UPDATE, and WRITE. 


Some typical CHANGE examples using modifiers and other commands are: 


Changes all occurrences of BOB to ROBERT in the current work-space file 


@ @C ALL ‘BOB’ TO ‘ROBERT’ 


@C ‘BOB’ TO ‘ROBERT’ LIST 


Changes the first occurrence of BOB to ROBERT on every line in the current work-space file and lists on the printer 
the lines where the changes were made 


@ON 10:20 COL 5:7 C TO ‘BOB’ 


Changes columns 5 through 7 on lines 10 through 20 of the current work-space file to BOB 
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CO 


3.4. COPYING LINES (@COPY) 
The COPY command copies specified lines to new line locations in the work-space file 
without deleting the original lines. You can copy a single line, nonconsecutive lines, 
consecutive lines, lines containing a specified string, or any combination of these lines. 
The format is: 

@COPY [ Line-range][ 'search-string'[{ *n]] TO destination 

NOTE: 


At least one of the optional parameters must be specified. 


The help screen format is: 


SYNTAX7: @CO[PY] <LINE-RANGE> TO <DESTINATION> 


SYNTAX2: @CO[PY] <SEARCH-STRING> TO <DESTINATION> 





where: 


Line-range 
Specifies by line numbers, special symbols, or EDT variables a single line, 
nonconsecutive lines, consecutive lines, or any combination of these lines to 
be copied. Consecutive line ranges must be specified in ascending order. 


'search-string' 
Specifies by a string in the lines those lines to be copied. The search string is 
usually enclosed in apostrophes; however, it may also be enclosed in quotes 
Or a combination of apostrophes and quotes. Only one search string may be 
specified. Multiple copies of the search string may be specified by using the 
string multiplication factor *n, where n is the number of times the original 
search string is multiplied. After multiplication, the product of the number of 


characters in the string being multiplied and the string multiplication factor 
cant exceed 50. 
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destination 
Specifies by line number or line numbers the new line location or locations for 
copied lines. A single destination or multiple destinations may be specified. 


When a single destination is specified, it’s either the starting and ending point 
for a single line being copied (i.e., a line specified by a single line number or 
special symbol) or it’s the starting point for multiple lines being copied (i.e., 
lines specified by a search string, line numbers, special symbols, or a 
combination of them). 


When multiple destinations are specified: (1) a single line is copied to each 
specified destination, for example, @COPY 2 TO 32, 40 copies line 2 to lines 
32 and 40, and (2) multiple lines are copied to successive lines beginning at 
each specified destination. For example, @COPY 5, 10, 15 TO 25, 50 copies 
lines 5, 10, and 15 to lines 25, 26, and 27 and to lines 50, 51, and 52 
respectively. 


Some typical COPY command examples are: 


@CO 17TO5 


Copies line 1 to line 5 


@CO 2,6,9 TO 20 


Copies lines 2, 6, and 9 to lines 20, 21, and 22 respectively. (Note that the implied increment in the destination is 
1) 


@CO 1:9 TO 30(.2) 


Copies lines 1 through 9 to lines 30, 30.2, 30.4, 30.6, etc. (Note that the increment of the destination is explicitly 
set to .2.) 


@CO 1,3,5:9 TO 10(.3), 50 
Copies lines 1, 3, and 5 through 9 first to lines 10, 10.3, 10.6, 10.9, etc and then to lines 50, 51, 52, 53, etc 


@CO ‘.’*7 TO 10 
Copies the first line containing ....... (a separator between data fields, for example) to line 10 and any subsequent 
lines containing that string to lines 11, 12, 13, etc 


@CO ‘ACCOUNT 48’ TO 15 


Copies the first line containing ACCOUNT 48 to line 15 and any subsequent lines containing ACCOUNT 48 to lines 
16, 17, 18, etc. (See note 3.) 


@CO % TO 175 


Copies the lowest line (%) in the current work-space file to line 175 


@CO 57 ‘PAYROLL’ TO 200 
Copies line 57 to line 200 if it contains PAYROLL 
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NOTES: 


i 


Lines are copied in the order that they are specified in the command. In the case of 
a search string (for instance, all lines containing ACCOUNT 48), lines are copied in 
the order that they appear in the work-space file. 


Remember that if lines are copied to destinations beyond the highest line in the 
current work-space file, the current work-space line number is reset to the highest 
destination line plus the current increment. 


When you copy all lines specified by a search string only, make sure that you copy 
them to a line destination lower than the first occurrence of the search string; 
otherwise, a program loop will develop. If, however, you specify a_ higher 
destination and a loop does develop, press F2 (function key 2) to terminate it. 


The following command modifiers can be added to the COPY command, increasing its 
capability: COLUMN, FIRST, and NOT. 


Commands that can be combined with the COPY command that permit faster and more 
efficient editing are: CHANGE, DELETE, FIND, FSTATUS, INSERT, LIST, PRINT, PUNCH, 
READ, REMOVE, SEQUENCE, UPDATE, and WRITE. 


Some typical COPY examples using modifiers and other commands are: 


@CO FIRST ‘PENNY’ TO 85 


Copies the first line containing PENNY in the current work-space file to line 85 


@CO 7:10 TO 90 PRINT 


Copies lines 7 through 10 to lines 90, 91, 92, etc and displays the newly copied lines 





UP-8828 Rev. 2 SPERRY UNIVAC OS/3 3-11 
GENERAL EDITOR (EDT) 





3.5. DELETING LINES (@DELETE) 

The DELETE command erases specified lines from the current work-space file. You can 
erase a single line, nonconsecutive lines, consecutive lines, lines containing a specified 
string, or any combination of these lines. 

The format is: 


@DELETE [ line-range][ 'search-string'[ «n] ] 


The help screen format ts: 


SYNTAX1: @D[LELETE] [<LINE-RANGE> ] 


SYNTAX2: @DLELETE][<SEARCH-STRING>] 





@ where: 


line-range 
Specifies by line numbers, special symbols, or EDT variables a single line, 
nonconsecutive lines, or any combination of these lines to be deleted. 
Consecutive line ranges must be specified in ascending order. 


'search-string' 

Specifies by a string in the lines those lines to be deleted. The search string is 
usually enclosed in apostrophes; however, it may also be enclosed in quotes 
or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the search string may be specified by using the 
string multiplication factor *n, where n is the number of times the original 
search string is multiplied. After multiplication, the product of the number of 
characters in the string being multiplied and the string multiplication factor 
can't exceed 50. 


NOTE: 


If you use only the @D command all lines in the current work-space file are deleted. 
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Some typical examples of the DELETE command are: 


@D 5 


Erases line 5 


@D 1,4,7,9 


Erases lines 1, 4, 7, and 9 


@D 10:15 


Erases lines 10 through 15 


@D ‘DIRECTORY’ 
Erases every line containing DIRECTORY 


@D °."*10 


Erases every line containing .......... as a separator between data, for example. 


@D % 


Erases the lowest line (%) in the current work-space file 


@D 3,8 ‘ITEM 10° 


Erases line 3 if » contains ITEM 10 and erases line 8 if it contains ITEM 10 


The following command modifiers can be added to the DELETE command, altering its 
capability: COLUMN, FIRST, NOT, and ON. 


Commands that can be combined with the DELETE command that permit faster and 
more efficient editing are: CHANGE, COPY, FIND, INSERT, PRINT, REMOVE, SEQUENCE, 
and UPDATE. 


Some typical DELETE examples using modifiers and other commands are: 


@LIST ALL ‘TRUCKS’ D 


Prints all lines containing TRUCKS and then deletes them 


@FIND ‘CARS’ D 


Locates the first line containing CARS in the current work-space file and deletes that line 
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FIN 


3.6. LOCATING DATA (@FIND) 

The FIND command locates the first occurrence of a specified string in the work-space 
file and assigns its corresponding line number to the variable symbol ?, and it assigns 
the column numbers of the first and last columns the string occupies to the left bracket 
([} and the right bracket (]) respectively. The line containing the specified string is not 
displayed unless the FIND command is combined with the PRINT command. 

The format is: 


@FIND 'search-string'[ «n] 


The help screen format is: 


SYNTAX: @FIN[D] <SEARCH-STRING> 





where: 


search-string 

Specifies a string to be located in the work-space file. The search string is 
usually enclosed in apostrophes; however, it may also be enclosed in quotes, 
or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the search string may be specified by using the 
string multiplication factor *«n, where n is the number of times the original 
search string is multiplied. After multiplication, the product of the number of 
characters in the string being multiplied and the string multiplication factor 
can t exceed 50. 


The purpose of assigning line and column numbers to variables is that it enables you to 
execute other EDT commands against a line containing a particular string (or the string 
itself) without knowing the corresponding line or column numbers. Instead, you know 
the variable that stands for the line or column number. 


Some typical examples of the FIND command are: 


@FIN ‘CURRENT BALANCES’ 


Locates the first occurrence of CURRENT BALANCES in the work-space file. If, for example, it appears on line 8 in 
columns 5 through 20, ? is set to 8, [ is set to 5, and ] is set to 20. 


@FIN ‘.’*10 
Locates the first occurrence of .......... (a separator between data fields, for example) in the work-space file. If, for 
example, it appears on line 10 in columns 12 through 21, ? is set to 10, [ is set to 12, and ] is set to 21. 
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NOTE: 


Once the variables ?, [, and ] are defined by the FIND command, they retain those 
values throughout the EDT session until another successful search operation (a 
command containing another search string) is issued to change them. 


The following command modifiers can be added to the FIND command, altering its 
capability: ALL, COLUMN, FIRST, NOT, and ON. 


Commands that can be combined with the FIND command that permit faster and more 
efficient editing are: CHANGE, COPY, DELETE, FSTATUS, INSERT, LIST, MOVE, 
NUMBER, PRINT, PUNCH, READ, REMOVE, SEQUENCE, UPDATE, and WRITE. 


some typical FIND examples using modifiers and other commands are: 


@FIN ‘JOE SMITH’ MOVE TO 25 


Locates the first occurrence of JOE SMITH and moves the line containing it to tine 25 


@ON 8 FIN ‘SUSAN MORRIS’ 


Locates the first occurrence of SUSAN MORRIS on line 8. If, for example, the string appears in columns 10 through 
21, ? is assigned the value 8 and [ and ] are assigned the values 10 and 21 respectively. 
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FS 


3.7. LISTING MODULE NAMES AND TYPES (@FSTATUS) 

The FSTATUS command creates in the work-space file a list of all modules contained in 
a specified program library. The list of modules is created using the current line and 
increment in the work-space file. Each line of the list contains the module name, module 
type, creation date, creation time, and comment field. 


Format: 


@F STATUS [MODULE=moduLe-name] oe (or mm 
[, 


‘filename! 
''filename'' 





,EILENAME={ filename 7 te eseeuacat. VSN=volumef ,DEVICE= did 





The help screen format is: 


MODULE -TYPE 
GESTATUS PMODULESMODUCE-NAMETT; FYPE=< >] 


FILENAME DID 
[,FILENAME=<'FILENAME' >] [,RDPASS=PASSWORD] [,VSN=VOLUME] [,DEVICE=<DISK >] 
‘FE TLENAME!! DISKETTE 





NOTE: 


You will not immediately see this help screen when you first issue the @PROMPT 
command to get help with the @FSTATUS command. To see this help screen, you 
must press FK13 for additional help. 
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where: 


MODULE=module-name 
Specifies the name of a specific module to be listed. It can be from one to 


eight alphanumeric characters with the first character being alphabetic. If you 
specify a module name, EDT lists information about that module only. 


—— 


Specifies the type of module to be read. For SAT files, the types permitted are 
source (S), macro (M), procedure (P), load (L), object (OQ), or proc-name (PN). 
For MIRAM files, the types permitted are screen format (F) or (FC), help screen 
(HELP), saved run library (J), or menu (MENU). 
FILENAME={ filename 
[1 iCenne | 
''filename''! 
Specifies the name of the program library. It can be from 1 to 44 alphanumeric 


characters. The file name must be enclosed in apostrophes or quotes when 
embedded spaces, parentheses, or commas are used in It. 


RDPASS=password 


Specifies a read password that restricts access to a file. The password is 
required only if a password entry for the file already exists in the system file 
catalog. The password can be from one to six alphanumeric characters. 


VSN=volume 
specifies the volume serial number of the volume containing the file. The 
number can be from one to six alphanumeric characters. You must specify this 
parameter unless you previously entered the file in the system file catalog. If 
you don’t know the vsn of the volume containing the file, you can specify the 
DEVICE parameter instead. 





Specifies the device where the file resides. did specifies the device address 
(did) of the device. The first digit is the channel number; the second and third 
specify the hardware address. The other choices, DISK and DISKETTE, specify 
the type of device, but not the specific device. If you do not specify a device, 
the parameter defaults to the disk or diskette having the vsn specified in the 
VSN parameter. 
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A typical example of the FSTATUS command is: 


.9000raFS FIL=LIBFILE, VSN=D01906 
-900OraP27:30 
.9000rS-ABC comment 80/03/95 


.0000rS-DEF comment 80/03/07 
-99OOrP-XYZ comment 80/04/09 
.9000r>P -MNO comment 80/95/25 





Here, the FSTATUS command on line 27 produces a list of the modules contained 
in the library LIBFILE. Notice that LIBFILE contains the source modules ABC and DEF 
and the procedure modules XYZ and MNO. 


Commands that can be combined with the FSTATUS command that permit faster and 
more efficient editing are: CHANGE, COPY, FIND, INSERT, REMOVE, and SEQUENCE. 


A typical example of FSTATUS combined with other commands is: 


@FS FIL=‘FILEJ’, VSN=DO00028 SEO * COL 100 


Inserts sequence numbers starting with the current work-space line number (*) in columns 100 through 108 for 
each directory (module name and type) listed for the file FILE J 
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3.8. INSERTING DATA (@INSERT) 


The INSERT command inserts a specified string into lines in the current work-space file. 
Existing characters are shifted to the right to insert the string. If the insertion causes the 
line to exceed the maximum line length, the line is truncated to the maximum length. 
The format is: 


@INSERT 'change-string'[ «n] 


The help screen format is: 


SYNTAX: @ICNSERT] <CHANGE-STRING> 





where: 


‘'change-string' 
Specifies a string to be inserted into the work-space file. This string must be 
enclosed in apostrophes. Multiple copies of the change string may be specified 
by using the string multiplication factor «+n, where n is the number of times the 
original change string is multiplied. After multiplication, the product of the 
number of characters in the string being multiplied and the string multiplication 
factor can't exceed 50. 


Unless otherwise specified, the string is inserted beginning in column 1 on every line. 
Existing characters are shifted to the right (the length of inserted string) to incorporate 
the insert. 


some typical examples of the INSERT command are: 


@| ‘ABC’ 


inserts A in column 1, B in column 2, and C in column 3 on every line in the current work-space file 


@l *.’*10 
Inserts .......... (a separator between data fields, for example) in columns 1 through 10 on every line in the current 
work-space file. 
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The following command modifiers can be added to the INSERT command, altering its 
capability: COLUMN, FIRST, and ON. 


Commands that can be combined with the INSERT command that permit faster and 
more efficient editing are: COPY, DELETE, FSTATUS, LIST, MOVE, PRINT, PUNCH, 
READ, UPDATE, and WRITE. 


Some typical INSERT examples using modifiers and other commands are: 


@COL 7 | ‘YEAR’ 


Inserts YEAR in columns 7 through 10 on every line in the current work-space file 


@ON 4 COL 12:15 | ‘1980' P 


Inserts 1980 in columns 12 through 15 on line 4, and then displays line 4 
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3.9. LISTING LINES ON THE PRINTER (@LIST) 

The LIST command lists specified lines from the current work-space file on the printer. 
You can list a single line, nonconsecutive lines, consecutive lines, lines containing a 
specified string, or any combination of these lines. The @LIST command does not list 
the work-space line numbers or any EDT commands you may have used while entering 
the lines in the current work-space file. 


The format is: 


@LIST [ Line-range][ ‘search-string'[ *n]] [ IMMEDIATE] 


The help screen format is: 


SYNTAX1: @L[IST][<LINE-RANGE>][IM[MEDIATE] ] 


SYNTAX2: @L[EIST][<SEARCH-STRING>][IM[MEDIATE] ] 





where: 


Line-range 
Specifies by line numbers, special symbols, or EDT variables a single line, 
nonconsecutive lines, consecutive lines, or any combination of these lines to 
be printed. Consecutive line ranges must be specified in ascending order. 


search-string 

Specifies by a string in the lines those lines to be printed. The search string is 
usually enclosed in apostrophes; however, it may also be enclosed in quotes 
or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the search string may be specified using the string 
multiplication factor *«n, where n is the number of times the original search 
string is multiplied. After multiplication, the product of the number of 
characters in the string being multiplied and the string multiplication factor 
cant exceed 50. 


IMMEDIATE 
Indicates that the data lines specified in the LIST command are listed 
immediately on the printer. If IMMEDIATE is not specified, the lines aren't 
listed until the end of the EDT session. 
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NOTE: 


Using only the @L command without any parameters causes all lines in the current 
work-space file to be listed on the printer. 


Some typical examples of the list command are: 


@L 9 


Lists line 9 on the printer 


@L 2,4,7 


Lists lines 2, 4, and 7 on the printer 


@L 20:25 


Lists lines 20 through 25 on the printer 


@L ‘REPORT’ 


Lists all lines containing REPORT on the printer 


@L 3,11:13, $ 


Lists line 3, lines 11 through 13, and the highest line in the current work-space file ({$) on the printer 


@L ‘..*10 IM 
Lists on the printer all lines containing .......... (a separator between data fields, for example). Lines are listed 
immediately, rather than at the end of the EDT session. 


NOTE: 


Lines are listed in the order that they are specified in the command; when specifying a 
search string, lines are listed in the order that they appear in the work-space file. 


The following command modifiers can be added to the LIST command, altering its 
capability: NOT, ON, and SHOW. | 


Commands that can be combined with the LIST command that permit faster and more 
efficient editing are: CHANGE, COPY, FIND, INSERT, REMOVE, and SEQUENCE. 


Some typical examples of the LIST command using modifiers and other commands are: 


@FIND ‘QUESTION’ L 


Locates the first occurrence of QUESTION in the work-space file and lists the line containing it on the printer 


@ON 1:10 L ‘FALSE’ 


Lists on the printer any line from 1 to 10 that contains FALSE 
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3.10. MOVING LINES (@MOVE) 
The MOVE command transfers specified lines to new line locations (destinations) in the 
work-space file and erases the original lines and line numbers. You can move a single 
line, nonconsecutive lines, consecutive lines, lines containing a specified string, or any 
combination of these lines. The MOVE command is actually a COPY command followed 
by a DELETE command. Each line is deleted immediately after being copied. 
The format is: 

@MOVE [ line-range][{ 'search-string'[ *n]] TO destination 

NOTE: 


At least one of the optional parameters must be specified. 


The help screen format is: 


SYNTAX1: @M[OVE] <LINE-RANGE> TO <DESTINATION> 


SYNTAX2: @M[OVE] <SEARCH-STRING> TO <DESTINATION> 





where: 


line-range 
Specifies by line number or line numbers, special symbols, or EDT variables a 
single line, nonconsecutive lines, consecutive lines, or any combination of 
these lines to be moved. Consecutive line ranges must be specified in 
ascending order. 


'search-string' 
Specifies by a string in the lines those lines to be moved. The search string is 
usually enclosed in apostrophes; however, it may also be enclosed in quotes 
or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the search string may be specified by using the 
string multiplication factor *n, where n is the number of times the original 
search string is multiplied. After multiplication, the product of the number of 


characters in the string being multiplied and the string multiplication factor 
cant exceed 50. 
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destination 
Specifies by a line number the starting point for the new line location or 
locations for moved lines. Only a single destination may be specified. 


When moving a single line, the destination line number is the starting and 
ending point of the moved line. However, the destination line number is the 
starting point for multiple lines being moved ({i.e., lines specified by a search 
string, line range, special symbols, or a combination of them). 


Some typical examples of the MOVE command are: 


@M 6 TO 12 


Moves line 6 to line 12 


@M 4,8,12 TO 20 


Moves lines 4, 8, and 12 to lines 20, 21, and 22 respectively 


@M 10:20 TO 30(.4) 


Moves lines 10 through 20 to lines 30, 30.4, 30.8, etc. Notice that the increment for the line destinations is 
explicitly set to .4 


@M ‘PRICES’ TO 10 


Moves all the lines containing PRICES in the current work-space file to lines 10, 11, 12, etc. (See note 3.) 


@M % ‘COST’ TO 500 


Moves the lowest line (special symbol %) in the current work-space file to line 500 if it contains COST 


@M ‘."*10 TO 15 


Moves ail lines containing .......... (a separator between data fields, for example) to lines 15, 16, 17, etc 


NOTES: 


Lines are moved in the order that they are specified in the command; when 
specifying a search string, lines are moved in the order that they appear in the 
work-space file. 


Remember that if lines are moved to destinations beyond the highest line in the 
current work-space file, the current line number is set to the highest destination 
plus the current increment. 


When you move all lines specified by a search string only, make sure that you 
move them to a line destination lower than the first occurrence of the search string; 
otherwise, a program loop will develop. If, however, you specify a_ higher 
destination and a loop does develop, press F2 (function key 2) to terminate It. 
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The following command modifiers can be added to the MOVE command, increasing its © 
capability: COLUMN, FIRST, NOT, and ON. 


Commands that can be combined with the MOVE command that permit faster and more 


efficient editing are: CHANGE, FIND, INSERT, PRINT, REMOVE, SEQUENCE, 


and 
UPDATE. 


some typical MOVE examples using modifiers and other commands are: 


@COLUMN 50 M ‘BILLS’ TO 7.01 


Moves all lines containing BILLS starting in column 50 to lines 7.01, 7.02, 7.03, etc 


@M 4 TO 24 UPDATE 


Moves line 4 to line 24 and then displays line 24 to be updated via the UPDATE command 
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NU 


3.11. INSERTING SEQUENCE NUMBERS INTO INPUT LINES (@NUMBER) 


The NUMBER command inserts sequence numbers into subsequent data lines keyed in 
at the workstation. The number command lets you sequence data. 


The format is: 
@ NUMBER 'sequence-string'[ *n] [BY increment] 


The help screen format is: 


SYNTAX: @NU[MBER] <SEQUENCE-STRING> [B[Y] <INCREMENT> ] 





where: 


'sequence-string' 

Specifies an alphanumeric string that is to be inserted on the next line keyed in 
at the workstation. The sequence string must be enclosed in apostrophes and 
one or more of its rightmost characters must be an integer from O to 9. A 
sequence string of up to 15 characters may be specified. Multiple copies of 
the sequence string may be specified by using the string multiplication factor 
*n, where n is the number of times the original sequence string is multiplied. 
After multiplication, the product of the number of characters in the string being 
multiplied and the string multiplication factor can’t exceed 50. 


increment 


Sets the increment for sequence strings inserted into input lines. A number of 
up to nine decimal digits may be specified as the increment. 


Unless tabs have been set for the EDT session, the NUMBER command in its basic 
format inserts sequence numbers beginning in column 1 on subsequent data lines. If 


tabs have been set, EDT processes the tabs first before inserting the sequence 
numbers. 


Sequence numbers do not appear on the screen as you enter your data. However, if 
you want to see the sequence numbers included in the lines, issue the appropriate 


PRINT command to display them on the workstation screen. 


Sequence numbering continues until you enter the next EDT command. 








UP-8828 Rev. 2 SPERRY UNIVAC OS/3 3-26 
GENERAL EDITOR (EDT) 


A typical example of the NUMBER command is: _ 


@NU ‘EXT200° BY 5 


Inserts the sequence string ‘EXT200'° in columns 1 through 6 on the next line keyed in at the workstation and 
places increments of 5 of that sequence string on subsequent lines keyed in. EXT205 will be inserted on the 
second line keyed in, EXT210 on the third line, EXT215 on the fourth line, and so forth. 


The only command modifier that can be added to the NUMBER command is COLUMN. It 
enables you to insert sequence numbers starting in a column other than 1. 


Commands that can be combined with the NUMBER command that permit faster and 
more efficient editing are: PRINT and UPDATE. 


Some typical NUMBER examples using modifiers and other commands are: 


@NU ‘0001’ BY 0001 COL 77 


Inserts sequence numbers in columns 77 through 80 on input lines beginning with the sequence string 0001 and 
incrementing it by 0001 


@NU ‘X500' BY 5 PRINT 


Inserts sequence numbers in columns 1 through 4 on input lines (starting with the sequence string X500 and 
incrementing it by 5) and displays the lines 
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3.12. DISPLAYING LINES (@PRINT) 

The PRINT command displays specified lines from the work-space file on the 
workstation screen. You can display a single line, nonconsecutive lines, consecutive 
lines, lines containing a specified string, or any combination of these lines. 

The format is: 


@PRINT [ Line-range][ 'search-string'[ *n] ] 


The help screen format is: 


SYNTAX1: @P[RINT][<LINE-RANGE> ] 


SYNTAX2: @P[RINT][<SEARCH-STRING> ] 





@ where: 


line-range 
specifies by line numbers, special symbols, and EDT variables a single line, 
nonconsecutive lines, consecutive lines, or any combination of these lines to 
be displayed. Consecutive line ranges must be specified in ascending order. 


'search-string' 

Specifies by a string in the lines those lines to be displayed. The search string 
is usually enclosed in apostrophes; however, it may also be enclosed in quotes 
or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the string can be specified through the use of the 
String multiplication factor *«n, where n is the number of times the string is 
multiplied. After multiplication, the product of the number of characters in the 
string being multiplied and the string multiplication factor can’t exceed 50. 


EDT displays the lines you request with the PRINT command according to your 
specification for the SCRDSPLY parameter on the @SET_ directive. If 
SCRDSPLY=TRUNCATE, EDT displays one record per one screen line and truncates 
lines if necessary; if SCRDSPLY=FOLD, EDT displays one record per two screen lines 
and doesn t truncate lines. 
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After EDT prints a full screen or the last screen, you have four options: 
1. You can update the displayed lines and transmit them to the EDT work space. 
2. You can display remaining specified lines by pressing the F19 function key. 


3. You can prevent the display of succeeding lines by pressing function key F1 or 
F18. 


4. You can terminate the entire PRINT command by pressing function key F2. 


For more information on the use of these and other function keys, see Section 9 and 
the interactive services commands and facilities user guide/programmer reference. 


NOTE: 


If you use the PRINT command without any parameters, all the lines in the current 
work-space file are displayed. 


Some typical examples of the PRINT command are: 


@P 23 


Displays line 23 on the workstation screen 


@P 3,16 


Displays lines 3 and 16 on the workstation screen 


@P 4:9 


Displays lines 4 through 9 on the workstation screen 


@P ‘TIME’ 


Displays on the workstation screen all lines in the current work-space file that contain TIME 


@P 2, 24:28, 32 ‘MEMBERS’ 


Displays on the workstation screen line 2, lines 24 through 28, or line 32 if the lines contain MEMBERS 


@P °.'+10 
Displays on the workstation screen all lines in the current work-space file containing .......... (a separator between 
data fields, for example) 


Lines are displayed in the order specified in the command; when specifying a search 
string, lines are displayed in the order that they appear in the work-space file. 
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The following command modifiers can be added to the PRINT command, altering its 
capability: ALL, COLUMN, NOT, ON, and SHOW. 


Commands that can be combined with the PRINT command that permit faster and more 


efficient editing are: CHANGE, COPY, DELETE, FIND, INSERT, MOVE, NUMBER, 
REMOVE, SEQUENCE, and UPDATE. 


Some typical PRINT examples using modifiers and other commands are: 


@CHANGE ALL ‘APPLES’ TO ‘PLUMS’ P 


Changes every occurrence of APPLES to PLUMS in the current work-space file and then displays all the lines where 
the changes were made 


@FIN ‘PEACHES’ P 


Locates the first occurrence of PEACHES in the work-space file and displays that line 
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PU 


3.13. PUNCHING LINES (@PUNCH) 

The PUNCH command reproduces specified lines from the work-space file on cards. 
You can punch a single line, nonconsecutive lines, consecutive lines, lines containing a 
specified string, or any combination of these lines. 

The format is: 


@PUNCH [ line-range][ 'search-string'[ *n]][ IMMEDIATE] 


The help screen format is: 


SYNTAX1: @PU[NCH] [<LINE-RANGE>]{IM[MEDIATE ] } 


SYNTAX2: @PU[NCH] [<SEARCH-STRING>][IM[MEDIATE] } 





where: 


line-range 
Specifies by line numbers, special symbols, or EDT variables a single line, 
nonconsecutive lines, consecutive lines, or any combination of these lines to 
be punched. Consecutive line ranges must be specified in ascending order. 


'search-string' 
Specifies by a string in the lines those lines to be punched. The search string 
is usually enclosed in apostrophes; however, it may also be enclosed in quotes 
Or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the search string may be specified by using the 
String multiplication factor *n, where n is the number of times the original 
search string is multiplied. After multiplication, the product of the number of 


characters in the string being multiplied and the multiplication factor can't 
exceed 50. 


IMMEDIATE 


Indicates that the data lines specified in the PUNCH command are to be 
punched immediately. If IMMEDIATE is not specified, the lines aren't punched 
until the end of the EDT session. 


NOTE: 


Using only the PUNCH command without any parameters (@PU) causes all lines in the 
current work-space file to be punched. 
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@ Some typical examples of the PUNCH command are: 


@PU 5 


Punches line 5 on a card 


@PU 1,6,8 


Punches lines 1, 6, and 8 on cards 


@PU 2:5 


Punches lines 2 through 5 on cards 


@PU ‘CHANNEL’ 


Punches on cards all lines in the current work-space file containing CHANNEL 


@PU °."*10 IM 
Punches on cards all lines in the current work-space file containing .......... (a separator between data fields, for 
example). Lines are punched immediately, rather than at the end of the EDT session. 


@PU 4, 9:11, 13:15, $ 
Punches line 4, lines 9 through 11, lines 13 through 15, and the highest line ($) in the current work-space file on 
cards 


®@ @PU ‘SPORTS’ 7,9 


Punches line 7 on a card if it contains SPORTS and also punches line 9 on a card if it contains SPORTS 


Lines are punched in the order specified in the command; when specifying a search 
string, lines are punched in the order that they appear in the work-space file. 


The following command modifiers can be added to the PUNCH command, altering its 
capability: COLUMN, NOT, and SHOW. 


Commands that can be combined with the PUNCH command that permit faster and 
more efficient editing are: CHANGE, COPY, FIND, INSERT, REMOVE, and SEQUENCE. 


Some PUNCH examples using modifiers and other commands are: 


@CHANGE ‘CARS’ TO ‘TRUCKS’ PU 


Changes the first occurrence of CARS on every line in the current work-space file to TRUCKS and then punches the 
changed lines on cards | 


@PU SHOW 20:30 


Punches only columns 20 through 30 of each line in the work-space file on cards 
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R 


3.14. READING DATA (@READ) 


The READ command reads a copy of either a program library module or a data file 
residing on disk, diskette, tape, or cards into the work-space file. 


The READ command is divided into seven basic formats. The formats are used to read 
to the current work-space file: 


a SAT* or MIRAM** library module on a disk or format label diskette; 
a MIRAM data file on a disk or format label diskette; 

a unit record file from a data set label diskette or card reader; 

a file from a tape; 

a file from the spool file; 


the same module or file last accessed through a previous @READ or @WRITE 
command; or 


the same module or file last accessed through a previous @READ or @WRITE 
command but read now with a KEY, KKEY, or SHOW parameter or any valid EDT 
command specified. 


The following paragraphs describe these seven formats and give examples for each. 
Here is some general information about the READ command that pertains to all seven 
formats: 


m You can enter the READ command via keywords or positional parameters. We 
discuss the keyword parameters here because theyre used most often. For 
information on how you can enter the READ command via positional parameters, 
see Appendix E. 


m Unlike the keywords in the other EDT commands, the keywords in the READ 
command may not be separated by spaces. If you leave spaces between them, 
EDT can't process the command and you'll receive an error message. 


= Commands that you can combine with the READ command for more efficient and 
faster editing are: CHANGE, COPY, FIND, INSERT, MOVE, SEQUENCE, and 
UPDATE. We provide examples of the @READ command in combination with other 
commands after the descriptions of the five formats so that you're familiar with the 
variouS parameters associated with the READ command when studying the 
examples. 


* SAT means system access technique 
*“MIRAM means multiple indexed random access method 
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= As we explained in the statement of conventions, we show the help screen 
formats you'll see when you issue an @PROMPT screen command along with the 
formats we present for the @READ command. You should note that you will not 
immediately see the help screens for the seven formats of the @READ command 
when you first issue the @PROMPT command to get help with the @READ 
command. To see help screens for the seven formats, you must follow the 
procedure for getting additional help from an @PROMPT command help screen. 
That is, you must press F13 for additional help until you see the format for the 
type of file you want to read. We describe the procedure for getting additional help 
from an @PROMPT command help screen in full detail in Section 8. 


Format 1 


To read a SAT or MIRAM library module from a disk or format label diskette to the 
current work-space file, use this format: 


QREAD MODULE=module-name icades vaumiaiiaaa | \ 





,FILENAME=({filename {[, RDPASS=password],VSN=volu 
'filename' 
‘'filename''! 





KEY=start-col-no:end-col-no 
KKEY=start-col-no:zend-col-no 
S 


K 
HOWAfirst-col-no:last-col-no 


The help screen format ts: 


MODULE-TYPE ES, 


Y 
@READ MODULE=MODULE -NAME PIERS. >] a aaa J 


FILENAME DID 
,FILENAME=<'FILENAME' > [,RDPASS=PASSWORD] ,VSN=VOLUME [,DEVICE=<DISK >] 
‘’FTLENAME!! DISKETTE 


KEY=START-COL-NO:END-COL-NO 
[<KKEY=START-COL-NO:END-COL-NO >] 
SHOW FIRST-COL-NO:LAST-COL-NO 





where: 


MODULE=module-name 


Specifies the name of the module to be read. It can be from one to eight 
alphanumeric characters with the first character being alphabetic. 
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= 


Specifies the type of module to be read. For SAT files, the types 
permitted are source (S), macro (M), procedure (P), load (L), object (O), or 
proc-name (PN). For MIRAM files, you may specify screen format (F) or 
(FC); help screen (HELP); saved run library (J); or menu (MENU). 





Specifies whether input record truncation should be reported. If you omit 
this keyword or specify NO, EDT truncates records but displays no 
warning message. This parameter applies only to MIRAM library modules, 
not SAT library modules. 


'filename' 

''filename''! 
Specifies the name of the program library containing the module. The file 
name is the LBL name of the file and can be from 1 to 44 alphanumeric 
characters. The file name must be enclosed in apostrophes or quotes 
when embedded spaces, parentheses, or commas are used in it. 


me | ina | 


RDPASS=password 


Specifies a read password that restricts access to a file. The password is 
required only if a password entry for the file already exists in the system 
file catalog. The password can be from one to six alphanumeric 
characters. 


VSN=volume 
Specifies the volume serial number of the file where the module resides. 
The number can be from one to six alphanumeric characters. You must 
specify this parameter unless you previously entered the file in the system 
file catalog. If you do not know the vsn of the disk or diskette your 
module resides on, you can specify the device address parameter 
(DEVICE) instead. 


ee | 
DISKETTE 


Specifi 

address (did) of the device you want to use. The first digit is the channel 
number; the second and third specify the hardware address. The other 
choices, DISK and DISKETTE, specify the type of device your module 
resides on, but not the specific device. If you do not specify a device, the 
parameter will default to the disk or diskette having the volume serial 
number you specified for the VSN parameter. 
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KEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers. They 
are deleted from their locations (as data) in the lines, and the lines are 
condensed accordingly. The columns specified by KEY must contain 
decimal characters. 


KKEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers and 
are also retained as data in the lines. The columns specified by KKEY 
must contain decimal characters. 


HOWATf irst-col-no:last-col-no 


Specifies the first and last column numbers of data to be used as input 
records. Data is read into the work-space file using the current line number 
and increment. 


NOTE: 


For more detailed information on the use of KEY, KKEY, and SHOW, refer to 
format 2 of the READ command. 


A typical example of reading a library module is: 


@R MO=MYPROG,FIL=LIBFILE,RD=PUBS, VSN=D00031 


This command reads into the current work-space file a copy of the library module 
MYPROG from the file LIBFILE on disk volume DOOO31. We specify the read 
password PUBS because the file was previously entered in the system file catalog 
with it. 


Format 2 


To read a MIRAM data file from a disk or format label diskette to the current 
work-space file, use this format: 


@READ FILENAME=/{filename [, RDPASS=password] 
'filename'! 
'!filename'' 


, VSN=volume hwaks =) /DEVICE=(did 


| C,BFSZ=n] 








EY=start-col-no:end-col-no 


KEY=start-col-no:end-col-no 
K 
SHOWAfirst-col -no:last-col-no 
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The help screen format is: 


where: 





F TLENAME 
M@READ FILENAME=<'FILENAME' > [,RDPASS=PASSWORD] 
'*FILENAME' ! 


DID 
) 
,VSN=VOLUME [,KEYNO=<,>] [,DEVICE=<DISK >][,BFSZ=N] 


DISKETTE 
YES 
[, TRUNC=< >] 
NO 


KEY=START-COL-NO:END-COL-NO 
[<KKEY=START-COL-NO:END-COL-NO >] 
SHOW FIRST-COL-NO:LAST-COL-NO 


FILENAME= (filename 


'filename'! 

''filename'!' 
Specifies the name of the data file to be read. The file name is the LBL 
name of the file and can be from 1 to 44 alphanumeric characters. The file 
name must be enclosed in apostrophes or quotes when embedded 
spaces, parentheses, Or commas are used in It. 


RDPASS=password 


Specifies a read password that restricts access to a file. The password is 
required only if a password entry for the file already exists in the system 
file catalog. The password can be from one to _ six alphanumeric 
characters. 


VSN=volume 


Specifies the volume serial number of the file to be read. The number can 
be from one to six alphanumeric characters. You must specify this 
parameter unless you previously entered the file in the system file catalog. 
If you do not know the vsn of the disk or diskette your file resides on, 
you can specify the device address parameter (DEVICE) instead. 





Specifies the number of the key to be used to sequentially read a MIRAM 
file. Keys are read in an alphanumeric sequence (A through Z and then O 
through 9). n may equal 1 to 5. 
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Specifies the device you want to read from. did specifies the device 
address (did) of the device you want to use. The first digit is the channel 
number; the second and third specify the hardware address. The other 
choices, DISK and DISKETTE, specify the type of device to be used, but 
not a specific device. If you do not specify a device, the parameter will 
default to the disk or diskette having the volume serial number you 


specified on the VSN parameter. 





BFSZ=n 


Specifies the minimum I/O buffer size for the file you want to read from. 
Specifying a larger than minimum buffer size could reduce the number of 
disk I/O calls, causing your command to run faster. Not specifying a buffer 
size causes this parameter to default to a buffer size appropriate to the 
type of file you want to read from. 





bos 


Specifies whether input record truncation should be reported. If you omit 
this keyword or specify NO, EDT truncates records but displays no 
warning message. 


KEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers. They 
are deleted from their locations (as data) in the lines, and the lines are 
condensed accordingly. The columns specified by the KEY parameter must 
contain decimal characters. 


KKEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers and 
are also retained as data in the lines. The columns specified by the KKEY 
parameter must contain decimal characters. 


SHOWAfirst-col-no:last-col-no 


Specifies the first and last column numbers of data to be used as input 
records. Data is read into the work-space file using the current line number 
and increment. 


The purpose of the KEY and KKEY parameters is to make it convenient for you to 
update existing modules or files. These parameters do this by letting you 
correspond your work-space line numbers to sequence numbers in your work-space 
lines. 
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For example, let's say you have an existing file, named FILEA, containing these @ 
records: 


@1 NAME1 ADDRESS1 
@2 NAME2 ADDRESS2 
95 NAME3 ADDRESS3 


If you include KEY=1:2 on your READ command, EDT reads your file so that the 
records no longer contain the key field you specified on the KEY parameter. 
Instead, it assigns your key fields to be its work-space line numbers and places a 
decimal point in the fourth position to the left of the last column number. 


In our example, EDT reads your file so that its work space looks like this: 


.9901>NAME1 ADDRESS74 
.@9@2>NAME2 ADDRESS2 
.9903>NAME5 ADDRESS3 


Notice that EDT placed the decimal point four places to the left of column 2 and 
inserted zeros to hold the significant digits. Throughout your file, your work-space 
line numbers correspond to your sequence numbers in this way. So you'd always 
know how to reference a line. For example, to change NAME1 to NAMEA, you 
would know to specify: 


JON .9001 CHANGE 'NAME1' TO 'NAMEA' @ 


The difference between the KEY and KKEY parameters is this: specifying KKEY 
causes EDT to retain the sequence numbers in your work-space line. For example 
(again using FILEA), if you include KKEY=1:2 on your READ command, EDT reads 
your file so your records still contain the columns specified with the KKEY 
parameter. But it assigns your key fields to be its work-space line numbers in the 
same way it did when you used KEY. Your work space now looks like this: 


.9001>01 NAME1 ADDRESS1 
.9002>@2 NAME2 ADDRESS2 
-9005>03 NAMES ADDRESS3 


Notice that you would still use the same command to change NAME1 to NAMEA 
on line .000O1. But, using KKEY instead of KEY on your READ command means that 


you can always see your original sequence numbers any time you do an @PRINT 
command. 
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The purpose of the SHOW parameter is to let you read into EDT’s work space only 
specific columns of your existing file. 


For example, let's assume you want to read your file, FILEA. But you want to read 
only the columns containing the names in the file. If you include SHOW 4:8 on your 
READ command, EDT reads in only the name field in columns 4 through 8 of the 
entire file. The work space looks like this: 

1.@000>NAME 1 


2 .9O00O>NAMEZ 
3.99O0@0>NAME3 


Now you can change the first name in the file by specifying: 
@ON 1 CHANGE 'NAME1' TO 'NAMEA! 


A typical example of reading a MIRAM data file is: 


aR FIL=DATA1,VSN=RELS71,DEV=DISKE 


This command reads a copy of the file DATA1 on diskette volume RELS71 into the 
current work-space file. 


A typical example of sequentially reading a MIRAM data file by keys is: 


aR FIL=DIVISIONS, VSN=RELO@70,KEYN=1 


This command reads into the current work-space file a copy of the file DIVISIONS 
on disk volume RELO7O. Lines are sequentially read by the first key in every line. 


Format 3 


To read a unit record file from a data set label diskette or from the card reader, use 


this format: 
@READ FILENAME= {FILENAME ,¥SN=VOLUME 
‘FILENAME! 
''FTLENAME!! 





DISKETTE KKEY=start-col-no:end-col-no 
SHOWAT irst-col-no:last-col-no 





SESE 


/DEVI ar | on \* eceveto -COL-NO:END-COL-NO 
RDR 
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The help screen format is: 


where: 


FILENAME 
@READ FILENAME=<'FILENAME' > ,VSN=VOLUME 
''FTLENAME!! 


DID 
YES 


/DEVICE=<DISKETTE> [,TRUNC=<.~ >] 
RDR NO 


KEY=START-COL-NO:END-COL-NO 
[<KKEY=START-COL-NO:END-COL-NO >] 
SHOW FIRST-COL-NO:LAST-COL-NO 





FILENAME=( filename 


‘filename’ 

‘'filename''! 
Specifies the name of the file to be read. The file name is the LBL name of 
the file and can be from 1 to 44 alphanumeric characters. The file name 
must be enclosed in apostrophes or quotes when embedded spaces or 
parentheses are used in it. A file name is required only when using 
diskette. 


VSN=volume 


DEVI 


Specifies the volume serial number of the file. The number can be from 
one to six alphanumeric characters. This parameter is required for diskette 
unless you don't know the vsn of the diskette. In that case, you can use 
the DEVICE parameter instead. Neither the VSN nor the DEVICE parameter 
is required if you've catalogued the unit record file you want EDT to read 
into its work space. 


CE=(did 


DISKETTE 

RDR 
Specifies the device you want to read from. did specifies the device 
address (did) of the device you want to use. The first digit is the channel 
number; the second and third specify the hardware address. The other 
choices, DISKETTE and RDR, specify the type of device to be used, but 
not a specific device. This parameter is required for the reader. If your unit 
record file is on diskette and you specified the VSN parameter, you do not 
have to specify the DEVICE parameter. Neither the VSN nor the DEVICE 
parameter is required if you've catalogued the unit record file you want 
EDT to read into its work space. 
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Specifies whether input record truncation should be reported. If you omit 
this keyword or specify NO, EDT truncates records but displays no 
warning message. This parameter applies only to MIRAM files. 


KEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers. They 
are deleted from their locations (as data) in the lines, and the lines are 
condensed accordingly. The columns specified by KEY must contain 
decimal characters. 


KKEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers and 
are also retained as data in the lines. The columns specified by KKEY 
must contain decimal characters. 


SHOWAfirst-col-no:last-col-no 


Specifies the first and last column numbers of data used as input records. 
Data is read into the work-space file using the current line number and 
increment. 


NOTE: 


For more information on the use of KEY, KKEY, and SHOW, see format 2 
of the READ command. 


A typical example of reading a unit record file is: 


@R FIL= ACCOUNT FILE” ,VSN=USER@5,DEV=DISKE 


This command reads a copy of the file ACCOUNT FILE on diskette volume USERO5 
to the current work-space file. 


Format 4 


To read a file from a tape, use this format: 


@READ FILENAME={ filename [, RDPASS=password] 
'filename' 
''filename'! 
,VSN=volume ,DEVICE=fdid 
TAPE 





A| (KEY=start-col-no:end-col-no 
KKEY=start-col-no:end-col-no 
SHOWAT irst-col-no:last-col-no 
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el 


The help screen format is: 


FILENAME 
M@READ FILENAME=<'FILENAME' > [,RDPASS=PASSWORD] 
''FETLENAME'' 


DID YES YES 


,;VSN=VOLUME ,DEVICE=< > [,BKNO=< >] [, TRUNC=< >] 
TAPE NO NO 


KEY=START-COL-NO:END-COL-NO 


[<KKEY=START-COL-NO:END-COL-NO >] 
SHOW FIRST-COL-NO:LAST-COL-NO 





where: 


FILENAME=( filename 
'filename' 
''filename'' 
Specifies the name of the file to be read. The file name is the LBL name of 
the file and can be from 1 to 44 alphanumeric characters. The file name 
must be enclosed in apostrophes or quotes when embedded spaces or 
parentheses are used in it. 


RDPASS=password 


Specifies a read password that restricts access to the file. The password 
is required only if a password entry for the file already exists in the 
system file catalog. The password can be from one to six alphanumeric 
characters. 


VSN=volume 
Specifies the volume serial number of the file. The number can be from 
one to six alphanumeric characters. You must specify this parameter 
unless it was previously entered in the system file catalog. lf you do not 
know the vsn of the tape, you can specify the device address parameter 
(DEVICE) instead. 


DEVICE=fdid 
trapel 
Specifies the device you want to read from. did specifies the device 
address (did) of the tape you want to use. The first digit is the channel 
number; the second and third specify the hardware address. TAPE 
specifies that you want to read from a tape; however, no specific tape is 
specified. 
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Specifies whether or not the block numbers of the file you want to read 
should be checked. If you specify YES, the block numbers will be 
checked. If you specify NO, the block numbers will not be checked. 


— 





specifies whether input record truncation should be reported. If you omit 
this keyword or specify NO, EDT truncates records but displays no 
warning message. This parameter applies only to MIRAM files. 


KEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers. They 
are deleted from their locations (as data) in the lines, and the lines are 
condensed accordingly. The columns specified by the KEY parameter must 
contain decimal characters. 


KKEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers and 
are also retained as data in the lines. The columns specified by the KKEY 
parameter must contain decimal characters. 


SHOWAfirst-col-no:last-col-no 
Specifies the first and last column numbers of data to be used as input 
records. Data is read into the work-space file using the current line number 
and increment. 
NOTE: 


For more information on the use of KEY, KKEY, or SHOW, see format 2 
of the READ command. 


A typical example of reading a file from tape Is: 


QR FIL=NATIONAL, VSN=RELX71,DEV=TA 


This command reads a copy of the file NATIONAL on tape volume RELX71 into the 
current work-space file. 
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Format 5 


To read a file from the spool file to the current work-space file, use this format: 





@READ [{ JOB=jobname]; ,HOLD=/L 
N 
Y 
, FILENAME= {filename [,ACCT=acct-no] 
'filename' 
‘'filename'! 
,QUEUE=/LOG ,ALL=/YES ,oKIP=fn , TRUNC=J YES 
PRINT [ f 10 Nik (a Nik ‘Wn i 
PUNCH 
ROR 


Aj (KEY=start-col-no:end-col-no 
KKEY=start-col-no:end-col-no 
SHOWAfirst-col-no:last-col-no 


NOTES: 


1. In order to read a spool file that was created at a workstation, you must issue 
the (QREAD command under the same user-id that was in effect when the 
spool file was created. You can enter the user-id via the LOGON command or 
by using the JCL option statement. This requirement protects spool files from 
unauthorized access and unintentional destruction. 


2. When you create spool files at the system console in console mode, you can 
later access these files only in console mode. When you create spool files at 
the system console in workstation mode, you can later access them only by 
using the same user-id you used when creating them. 


3. If you use the file name, it must be either the LBL name or the job name 
concatenated with the LFD name of the program that created the file. 


The help screen format is: 


L FILENAME 

QMREAD £ JOB=JOBNAME) [,HOLD=<N>] [,FILENAME=<'FILENAME' >] ([,ACCT=ACCT-NO] . 
Y ''FTLENAME'! 

» L0G YES N YES 

,QUEUE=<PRINT> [,ALL=< >] [,SKIP=< >] (,TRUNC=< >] 


PUNCH NO 0 NO 
RDR 
KEY=START-COL-NO:END-COL-NO 
[<KKEY=STARTCOL-NO:END-COL-NO >] 
SHOW FIRST-COL-NO:LAST-COL-NO 
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JOB=jobname 


Specifies the name of the job that produced the spool file. 


HOLD=(L 
N 
Y 


Specifies whether or not a spooled file has been placed in a HOLD state. 
Files are held in two ways. The first is through the use of a HOLD 
command, from the workstation or system console, or the inclusion of a 
HOLD job control parameter before processing. The second is by 
specifying the file to be retained after processing. A file placed in the 
HOLD state by the first method has not been processed. A file placed in 
the HOLD state by the second method has been processed at least once. 


If the file you want to read is a log file, and is in the HOLD state, enter L. 
lf the file you want to read is a type other than a log file and is in a HOLD 
state, enter Y. If the file you want to read, log or other type, is not in a 
HOLD state, enter N. If the file you want to read is in the RDR spool queue 
and was Specified to be retained after processing, it will not be in a HOLD 
state. Retained input files are not placed on HOLD. 


lf you omit the HOLD parameter and the file you want to read isn't on the 


reader queue, EDT locates the file regardless of what you specified for the 
HOLD spooling command for that file. 


‘filename! 


me Veter | 


''#ilename!! 
Specifies the logical name of the spool file and must be the LBL name 
from your job control or the job name concatenated with the LFD name. It 
can be from 1 to 17 alphanumeric characters. The file name must be 
enclosed in apostrophes when embedded spaces, parentheses, or 
commas are used in it. 


ACCT=acct-no 


Specifies the job account number that created the spool file. The account 
number may be from one to four alphanumeric characters. It’s always 
optional. 
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QUEUE=(LOG 

PRINT 

PUNCH 

RDR 
Indicates the spool queue containing the file you want to read. You may 
enter LOG, PRINT, PUNCH, or RDR. LOG indicates that the file is in the log 
queue. PRINT indicates that the file is in the printer queue. PUNCH 
indicates that the file is in the card punch queue. RDR indicates that the 
file is in the card reader queue. Specifying QUEUE=RDR forces the HOLD 
parameter to NO. 


ease 
NO 


Specifies whether or not all spool files with the specified parameters are 
to be read. If you specify YES, all the spool subfiles with the specified 
parameters are read. If you specify NO, only the first spool file found with 
the specified parameters is read. 


sae 


Specifies the number of spool files, with parameter values identical to 
those specified, that are to be skipped before reading a file. The default 
value O indicates that the first file found matching the specified parameters 
is read. n Is any integer. 





ssinlecaleetatatets 


a 
Specifies whether input record truncation should be reported. If you omit 
this keyword or specify NO, EDT truncates records but displays no 
warning message. This parameter applies only to MIRAM files. 


KEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers. They 
are deleted from their locations (as data) in the lines, and the lines are 
condensed accordingly. The columns specified by the KEY parameter must 
contain decimal characters. 


KKEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers and 
are also retained as data in the lines. The columns specified by the KKEY 
parameter must contain decimal characters. 


UP-8828 Rev. 2 SPERRY UNIVAC OS/3 3-47 
GENERAL EDITOR (EDT) 


SHOWAT irst-col-no:last-col-no 
Specifies the first and last column numbers of data to be used as input 
records. Data is read into the work-space file using the current line number 
and increment. 

NOTE: 


For more information on the use OF KEY, KKEY, or SHOW, see format 2 of 
the READ command. 


A typical example of reading a file from the spool file is: 


a@R FIL=PAYFILE,Q=PR 


This command reads into the current work-space file a copy of the file PAYFILE 
from the printer queue of the spool file. 


Format 6 


To read the same module or file last accessed through a previous @READ or 
@WRITE command into EDT’s work space, use this format: 


AREAD 


NOTE: 
There is no help screen for format 6 of the READ command. 


For example, let's say you create a library module and write it to a disk using the 
command, @WRITE MO=USERO1,FIL=FILE1,VSN=RELO80,SI=1,SAT=YES. After 
you write it out to the disk, however, you realize you need to make another change 
to it. To read the file back into EDT’s work space, you simply enter @READ and 
EDT reads your module back into its work space. 


Format 7 


To read the same module or file last accessed through a previous @READ or 
@WRITE command but read now with a KEY, KKEY, or SHOW parameter or any 
valid EDT command specified, use this format: 


KKEY=start-col-no:end-coi-no 


M@READA; Af (KEY=start-col-no:zend-col-no | [valid EDT command] 
SHOWAfirst-col-no:last-col-no 
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NOTE: 


There is no help screen for format 7 of the READ command. 


where: 


Specifies the same file parameters, with the exception of the KEY, KKEY, 
and SHOW, used in the most recent @READ or @WRITE command. 


KEY=start-col-no:end-col-no 


Specifies the starting and ending column number for keys used to read the 
file. The keys are used as the current work-space line numbers. They are 
deleted from their locations (as data) in the lines, and the lines are 
condensed accordingly. The columns specified by the KEY parameter must 
contain decimal characters. 


KKEY=start-col-no:end-col-no 


Specifies the starting and ending column numbers for keys used to read 
the file. The keys are used as the current work-space line numbers and 
are also retained as data in the lines. The columns specified by the KKEY 
parameter must contain decimal characters. 


SHOWAf irst-col-no:last-col-no 


Specifies the first and last column numbers of data to be used as input 


records. Data is read into the work-space file using the current line number 
and increment. 


NOTE: 


For more information on the use of KEY, KKEY, and SHOW, see format 2 of 
the READ command. | 


valid EDT command 


Specifies any EDT command that you want to combine with the READ 


command. Table 3-2 lists the valid commands you can combine with the 
READ command. 


Here's One example of the semicolon format: 
Let’s say you have an existing file in EDT’s work space that looks like this: 
@1 NAME1 ADDRESS1 PHONE-NO1 ACCOUNT-NO1 


@2 NAME2 ADDRESS2 PHONE-NO2 ACCOUNT -NO2 
03 NAME3 ADDRESS3 PHONE-NO3 ACCOUNT-NO3 
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You want to create a subset of this file in a new file so you include the SHOW 
parameter on your @WRITE command, like this: 


MWRITE FIL=MYFILE, VSN=REL080,SI=1 SHOW 1:26 


This command writes only the sequence number, name, address, and phone 
number fields to your new file. Next, you want to read your new file back into 
EDT’s work space, but you want to ignore the SHOW parameter so you can 
specify a KEY parameter, like this: 


AREAD ; KEY=1:2 


The semicolon tells EDT to read in the same file in the last @WRITE command but 
to ignore the SHOW parameter because you want to specify a KEY parameter. The 
KEY parameter tells EDT to read your file so that EDT’s work-space line numbers 
correspond to the sequence numbers in your file. For more information on KEY, 
KKEY, and SHOW, see format 2 of the READ command. 


Another example of the semicolon format is: 
@READ ; change ‘ABC! to 'DEF! 


This command reads into EDT’s work space the file specified in the previous READ 
or WRITE command but changes all occurrences of ABC to DEF. 


Some typical examples of the READ command combined with other commands are: 


@R FIL=‘FILE H,VSN=DOO0029 SEQ ‘1000’ BY 5 

Reads a copy of the file ‘FILE H’ on disk volume DOOO29 into the work-space file and inserts sequence numbers in 
columns 1 through 4 on each line, beginning with the sequence string 1000 and incrementing it by 5. Note that BY 
5 is not a parameter associated with the READ command, but is an EDT modifier, which we explain in Section 4. 


@R FIL=MYFILE,RD=LTO5,VSN=USERO1 FIN ‘JOHN’ 

Reads a copy of the file MYFILE (with password LTO5) on disk volume USERO1 into the work-space file and 
locates the first occurrence of JOHN (assigning the corresponding line and first and last column numbers to ?, [, 
and J, respectively). 
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REM 


3.15. DELETING DATA (@REMOVE) 
The REMOVE command deletes a specified string from lines in the work-space file. 
The format ts: 


@REMOVE ‘search-string'[ *n] 


The help screen format ts: 


SYNTAX: @REM[OVE] <SEARCH-STRING> 





where: 


'search-string' 

Specifies a string that is to be deleted from the work-space file. The search 
string is usually enclosed in apostrophes; however, it may also be enclosed in 
quotes or a combination of quotes and apostrophes. Multiple copies of the 
search string may be specified by using the string multiplication factor «n, 
where n is the number of times the original search string is multiplied. After 
multiplication, the product of the number of characters in the string being 
multiplied and the string multiplication factor can't exceed 50. 


The REMOVE command used in this basic format deletes the first occurrence of the 
specified string on each line in the work-space file. Lines are condensed to adjust for 
the deleted string. 


Some typical examples of the REMOVE command are: 


@REM ‘TOM’ 
Deletes the first occurrence of TOM on every line in the current work-space file. If TOM appears more than once 
on a line, the remaining occurrences are not deleted. This command is equivalent to @CHANGE ‘TOM’ TO". 


@REM “*.’*10 
Deletes the first occurrence of .......... (a separator between data fields, for example) on every line in the current 
work-space file 


The following command modifiers can be added to the REMOVE command, increasing 
its capability: ALL, COLUMN, FIRST, ON. 
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Commands that can be combined with the REMOVE command that permit faster and 
more efficient editing are: COPY, DELETE, FIND, FSTATUS, LIST, MOVE, PRINT, 
PUNCH, READ, UPDATE, and WRITE. 


Some typical REMOVE examples using modifiers and other commands are: 


@REM ALL ‘BOOKS’ 


Deletes all occurrences of BOOKS in the current work-space file 


@REM ‘TEAM #3’ PRINT 
Deletes the first occurrence of TEAM #3 on every line in the current work-space file and displays the lines where 
these changes were made 
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SEQ 


3.16. PLACING SEQUENCE NUMBERS INTO EXISTING LINES (@SEQUENCE) 


The SEQUENCE command places sequence numbers into existing lines in the current 
work-space file. The SEQUENCE command lets you resequence data. The format for the 
SEQUENCE command is: 


caaaiaciae, aiid lille BY ans 
* 


The help screen format is: 


SYNTAX1: @SEQ[UENCE} <x> 


SYNTAX2: @SEQ[UENCE] <SEQUENCE-STRING> BY <INCREMENT> 





where: 


‘'sequence-string' 

Specifies an alphanumeric string that is to be inserted on an existing line in the 
work-space file. The sequence string must be enclosed in apostrophes and one 
or more of its rightmost characters must be an integer from O to 9. A 
sequence string of up to 15 decimal digits may be specified. Multiple copies of 
the sequence string may be specified by using the string multiplication factor 
*n, where n is the number of times the original sequence string is multiplied. 
After multiplication, the product of the number of characters in the string being 
multiplied and the string multiplication factor can't exceed 50. 


increment 
sets the increment for sequence strings inserted into existing lines in the 
work-space file. A number of up to nine decimal digits may be specified. 


Indicates that the sequence string to be entered is the current work-space line 
number. 


The sequence string used in this format places sequence numbers on each line, 
beginning in column 1. When sequence strings are inserted into existing lines, they 
replace the contents of the columns rather than shifting the contents of the line to 
incorporate the string. 
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© Some typical examples of the sequence command are: 


@SEO 'ED20'*2 BY 5 


Overlays columns 1 through 8 on the first line in the current work-space file with the sequence string D20ED20 
and overlays columns 1 through 8 on subsequent (existing) lines with increments of 5 of that string 


@SEQ ‘A100' BY 10 


Overlays columns 1 through 4 on the first line of the current work-space file with the sequence string A100 and 
overlays columns 17 through 4 on subsequent (existing) lines with increments of 10 of that string 


Command modifiers that can be added to the SEQUENCE command are ON and 
COLUMN. ON allows you to insert sequence numbers on specific lines rather than on all 
lines in the current work-space file; COLUMN allows you to insert sequence numbers 
beginning in a column other than column 1. 


Commands that can be combined with the SEQUENCE command that permit faster and 
more efficient editing are: COPY, DELETE, FIND, FSTATUS, LIST, MOVE, PRINT, 
PUNCH, READ, UPDATE, and WRITE. 


Some typical SEQUENCE examples using modifiers and other commands are: 


@COL 73 SEQ ‘00001000’ BY 1 


Inserts sequence numbers in columns 73 through 80 on ali existing lines in the current work-space file 


(@WRITE FIL=MYFILE,VSN=DO0027 SEQ * 

Inserts sequence numbers into existing lines while writing the work-space file to a permanent file. Sequence 
numbers are inserted in columns 1 through 8 on every line beginning with the current work-space line number (the 
special symbol *) as the first sequence String. 
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3.17. UPDATING LINES (@UPDATE) 

The UPDATE command displays specified lines from the work-space file one at a time 
for you to edit or change. You can update a single line, nonconsecutive lines, 
consecutive lines, lines containing a specified string, or any combination of these lines. 


The format ts: 


QUPDATE [lLine-range]['search-string'(*n]] 


NOTE: 


You can’t use the @UPDATE command in screen mode. Instead, use the @ROLL 
screen command (Section 8). 


The help screen format ts: 


SYNTAX1: @U[PDATE][<LINE-RANGE> ] 


SYNTAX2: @U[PDATE][<SEARCH-STRING>] 





where: 


line-range 
Specifies by line numbers, special symbols, or EDT variables a single line, 
nonconsecutive lines, consecutive lines, or any combination of these lines to 
be updated. Consecutive line ranges must be specified in ascending order. 


'search-string' 

Specifies by a string in the lines those lines to be updated. The search string iS 
usually enclosed in apostrophes; however, it may also be enclesed in quotes 
Or a combination of quotes and apostrophes. Only one search string may be 
specified. Multiple copies of the search string may be specified by using the 
string multiplication factor *n, where n is the number of times the original 
search string is multiplied. After multiplication, the product of the number of 
characters in the string being multiplied and the string multiplication factor 
can't exceed 50. 


lf you do not specify a line range or a search string for the @UPDATE command, EDT 
displays every line in the EDT work space one line at a time so you can update them. 
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Once you enter the UPDATE command and EDT displays a data line, you may update 
the data line in five different ways. You can enter: 


m= @STRIKE to delete the entire line; 
m @NOCHANGE to leave the line unchanged; 
= @CONTINUE to continue the UPDATE command without displaying the lines; 


= an EDT command to terminate the entire UPDATE command and execute the 
specified command; or | 


@ anew data line to replace the existing line. 

NOTE: 

The tab character is ignored during an (®UPDATE process. 

You may key in these entries in two different locations on the screen. You may enter 
them at the end of the displayed line, but you must precede the entry with a 
start-of-entry (SOE) character (A). Or, you may move the cursor back to the beginning 
of the line and key in the entry over the existing line. 


NOTES: 


1. If a command is to be interpreted as a data line, remember to key in a double at 
sign (@@) rather than a single at sign (@). 


2. The STRIKE and NOCHANGE options cannot be used if the UPDATE command is 
combined with the COPY command. 


3. A null line in response to the UPDATE command deletes the line, that is, pressing 
the XMIT key with the cursor at the start-of-entry field. 


Some typical examples of the UPDATE command are: 


1.0000>aU 40 


40.90@@>DATA LINE TO BE UPDATED. > @asT 
1.9000> 





Here, the @U 40 command on line 1 displays line 40 to be updated. We delete the 
line by entering [ @ST at the end of the line and then transmitting It. 
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2.0000>aU 5,9 
5.09000>DATA LINE A Pm @N 


9.9O00O>DATA LINE J > NEW DATA LINE J? 
2.0000r 





Here, the @U 5,9 command on line 2 displays lines 5 and 9 one at a time to be 
updated. After each line is displayed, it is updated. We leave line 5 unchanged by 
entering [> @N at the end of line 5 and then transmitting it; we replace line 9 with 
a new data line by entering an SOE ( [> ) character and the new data at the end of 
line 9 and transmitting it. 


4.0000>0U 'SUMMARY' 
25.@000>SUMMARY A Db @N 


31.0@00>SUMMARY 10 > OPRINT 30 
39.9000>REPORT ITEM 82 
4.0000> 





Here, the @U ‘SUMMARY’ command on line 4 displays all lines containing 
SUMMARY in the current work-space file one at a time so that they can be 
updated. Notice that we leave line 25 (the first line in the work-space file containing 
SUMMARY) unchanged by entering [> @N at the end of the line and transmitting it. 
We then terminate the entire UPDATE command at line 31 (the second line 
containing SUMMARY) by entering an SOE character ( [> ) and the EDT command 
(@PRINT 30 at the end of line 31 and transmitting it. 


Lines are updated in the order that they are specified in the command. When using a 
search string, lines are updated in the order that they appear in the work-space file. 


The following command modifiers can be added to the UPDATE command, altering its 
capability: ALL, COLUMN, FIRST, and ON. 


Commands that may be combined with the UPDATE command that permit faster and 
more efficient editing are: CHANGE, COPY, DELETE, FIND, INSERT, LIST, MOVE, 
NUMBER, PRINT, REMOVE, and SEQUENCE. 
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A typical example of the UPDATE command used with modifiers and other commands 
IS: 


2.990@P00N 8:20 FIND 'SALARY' UPDATE 


16.90@0@>SALARY INCREASE DUE. P INCREASE DUE JANUARY 1983 
5 .9000r 





Here, the command on line 5 locates the first occurrence of SALARY on lines 8 
through 20 and displays the line for updating. The user keys in [> INCREASE DUE 
JANUARY 1983. EDT makes the change in the work space but doesn’t display the 
changed line because the user didn't enter an @PRINT command. EDT displays line 
5.000 to accept the next command. 
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wo ® 





3.18. CREATING AND SAVING DATA (@WRITE) 


The WRITE command writes a copy of the current work-space file to a program library 
module or data file on disk, diskette, tape, or to the spool file. If the file being written 
to does not already exist, the WRITE command enables you to create it and then write 
to it. If the file already exists, it can be overwritten with a copy of the current 
work-space file, or a copy of the current work-space file can be appended to the end of 
the file. The WRITE command can also copy the current work-space file to cards or the 
printer. 


The WRITE command is divided into seven basic formats. The formats are used to 
write the current work-space file to: 


a SAT or MIRAM library module on a disk or format label diskette; 
a MIRAM data file on a disk or format label diskette; 
a unit record file to a printer, card punch, or a data set label diskette; 


a file to a tape; © 


a file to the spool file; 





the same module or file last accessed through a previous @READ or @WRITE 
command; or 


the same module or file last accessed through a previous @READ or @WRITE 
command but written to now with any valid EDT command specified. 


The following paragraphs describe these five formats and give examples for each. Here 
is some general information about the WRITE command that pertains to all five formats: 


# Note the following information about how your system accesses files before writing 
them from the EDT work space to their permanent files. OS/3 does the following: 


— permits variable or fixed record length (1 to 2048 characters, depending on 
your specification for the BUFFER parameter of the @SET directive); 


— permits duplicate keys on multiple indexed file types; 


— assumes no change on index fields on multiple indexed file types, but allows 
you to change them if you want to; and 


— can't compile, link, or access programs as MIRAM program modules. If you © 
want your system to compile, link, or access a program, it must be written as 
a module of a SAT file. 
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m™ You can enter the WRITE command via keywords or positional parameters. We 
discuss keyword version here because it’s used most often. For information on 
how you can enter the WRITE command via positional parameters, see Appendix E. 


m Unlike the keywords in the other EDT commands, the keywords in the WRITE 
command can't be separated by spaces. If you leave spaces between them, EDT 
cant process the command and you'll receive an error message. 


=m Commands that you can combine with the WRITE command for more efficient and 
faster editing are: CHANGE, COPY, FIND, INSERT, REMOVE, and SEQUENCE. We 
provide examples of the @WRITE command in combination with other commands 
after the descriptions of the five formats so that you're familiar with the various 
parameters associated with the WRITE command when studying the examples. 


m= As we explained in the statement of conventions, we show the help screen 
formats you'll see when you issue an (@PROMPT screen command along with the 
formats we present for the @WRITE command. You should note that you will not 
immediately see the help screens for the seven formats of the @READ command 
when you first issue the @PROMPT command to get help with the @WRITE 
command. To see help screens for the seven formats, you must follow the 
procedure for getting additional help from an @PROMPT command help screen. 
That is, you must press F13 for additional help until you see the format for the 
type of file you want to write to. We describe the procedure for getting additional 
help from an @PROMPT command help screen in full detail in Section 8. 


m= After you issue an @WRITE command, issue an @DELETE command if you're not 
finished your EDT session. The @DELETE command erases lines in EDT’s work 
space so that the lines you already wrote to a permanent file aren't included with 
the lines you intend to enter next. | 


Format 1 


To write the current work-space file to a SAT or MIRAM library module on a disk 
or format label diskette, use this format: 


QWRITE MODULE=module-name f alae odule- ae | 


'filename' 


eee | tiara a ~ {e 
''filename'! 
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The help screen format is: 


where: 


MODULE-TYPE 
@WRITE MODULE=MODULE-NAME [,TYPE=< >j 
5 
FELENAME DID 
,»PELENAME=<'FILENAME' > [{,WRPASS=PASSWORD] ,VSN=VOLUME (,DEVICE=<DISK >] 


‘'FILENAME''! DISKETTE 
YES N ; YES 
[, CONTIG=< >] [,INC=< >] [,RCSZ=N] ([,SIZE=N} ([,SAT=< >} 
NO 1 NO 





MODULE=module-name 


T 


Y 


Specifies the name of the library module to be written. The module can be 
a language source module or a job control stream. If you're writing a job 
control stream, use its job name as the module name. In any case, the 
module name may be an existing name or one you create. It can be from 
one to eight alphanumeric characters with the first character being 
alphabetic. 


PE= rns 


Specifies the type of module to be written. For SAT files, the types 
permitted are source (S), macro (M), procedure (P), load (L), object (O), or 
proc-name (PN). For MIRAM files, you may specify screen format (F or 
FC), help screen (HELP), saved run library (J), or menu (MENU). 


You may create your own module types, identifying them with a 1- to 
4-character type. The module types can serve as qualifiers for the 
modules they are associated with. 


FILENAME={ filename 


‘filename! 

''filename'!' 
Specifies the name of the file where the module is to be written. The file 
name is the LBL name of the file and can be an existing LBL name, or, if 
you are creating the module now, you supply the LBL name with this 
parameter now. It can be from 1 to 44 alphanumeric characters. The file 
name must be enclosed in apostrophes or quotes when embedded 
spaces, commas, or parentheses are used in it. 


WRPASS=password 


Specifies the write password that restricts access to a file. The password 
is required only if a password entry for the file already exists in the 


system file catalog. The password can be from one to six alphanumeric 
characters. 
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VSN=volume 
Specifies the volume serial number of the file where the module is to be 
written. The number can be from one to six alphanumeric characters. You 
must specify this parameter unless you previously entered the file in the 
system file catalog. If you do not know the vsn of the disk or diskette you 
want to write to, you can specify the DEVICE parameter instead. 


DEVICE=(did | 


Specif REELS 













ies the device you want to write to. did specifies the device address 
(did) of the device you want to use. The first digit is the channel number; 
the second and the third specify the hardware address. The other choices, 
DISK and DISKETTE, specify the type of device you want to write to, but 
not the specific device. If you do not specify a device, the parameter will 
default to the disk or diskette having the volume serial number you 
specified on the VSN parameter. 





Specifies whether or not EDT allocates contiguous storage space to the 
file. If you specify YES, contiguous storage space is allocated. If you 
specify NO, noncontiguous storage space is allocated. 


me 


Specifies the number of cylinders to be added to a file each time it 
requires more storage space. This parameter is specified only when you 
create a new file. The default is 1. 


RCSZ=n 


Specifies the record size used when writing a MIRAM library module to a 
disk or format label diskette. The default is 256 bytes. Since EDT 
determines the record size of a SAT module according to the module 
type, this parameter applies only to MIRAM library modules. 


SIZE=n 


Specifies the number of cylinders initially allocated for a new file. This 
parameter is specified only when you create a new MIRAM file. 


Specifies whether the output file is a SAT or a MIRAM file. If the keyword 
is omitted, a MIRAM file is assumed. MIRAM files are used for data, 
screen format services modules, and saved job control modules, while 
SAT files are used for library modules. This parameter is required only 
when you are creating a new file. 
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A typical example of writing a library module to disk is: 


dW MO=MYPROG,FIL=LIBFILE, VSN=D00024 


This command writes the source module MYPROG to the existing SAT file LIBFILE 
on disk volume DOOO024. 


Format 2 


To write the current work-space file to a MIRAM data file on a disk or format label 
diskette, use this format: 


@WRITE FILENAME={ filename [, WRPASS=password] 
'filename' 
''filename''! 


,VSN=volume f CONTI " VES 


soailanail } 
0 


»KEYi=(start-col-no:end-col-no 
‘(iiieetcaein. 


Passos 
BERLE RS a | 
RSE s z Be: 
EXE Sect 


YES 


“| | _ t 10 














The help screen format is: 


FILENAME 
QWRITE FILENAME=<'FILENAME' 


YES FIX 
> {,WRPASS=PASSWORD] [,EXTEND=< >] [,RCFM=< 
‘1 FTLENAME!! 


NO VAR 


YES 
>} (,INC=< >] {,1INIT=< >) [,SIZE=n] 


>] 


YES DID N 
,VSN=VOLUME [, CONTIG=< >] £DEVICE=<DISK 


NO DISKETTE 1 NO 


DUP CHG YES 
{,KEYI=START-COL:END-COL [,< >) [,< 


NDUP NCHG NO 


N 
>)} [,RCB=< >] (,RCSZ=N] ([,SCR2=< >} 


256 
[,BFSZ2=N] 
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where: 


FILENAME={ filename 

‘filename! 

‘'filename''! 
Specifies the name of the file to be written. The file name is the LBL name 
of the file and can be an existing LBL name, or, if you are creating the file 
now, you supply the LBL name with this parameter now. The file name 
can be from 1 to 44 alphanumeric characters. The file name must be 
enclosed in apostrophes or quotes whenever embedded spaces, commas, 
or parentheses are used in it. 


WRPASS=password 


Specifies a write password that restricts access to a file. The password is 
required only if a password entry for the file already exists in the system 
file catalog. The password can be from one to six alphanumeric 
characters. 


VSN=volume 
Specifies the volume serial number of the disk or diskette where the 
specified file is to be written. The number can be from one to six 
alphanumeric characters. You must specify this parameter unless you 
previously specified the file in the system file catalog. If you do not know 
the vsn of the disk or diskette you want to write to, you can specify the 
DEVICE parameter instead. 





specifies whether or not EDT allocates contiguous storage space to the 
file. If you specify YES, contiguous storage space is allocated. If you 
specify NO, noncontiguous storage space Is allocated. 





Specifies the device you want to write to. did specifies the device address 
(did) of the device you want to use. The first digit is the channel number; 
the second and third specify the hardware address. The other choices, 
DISK and DISKETTE, specify the type of device to be used, but not a 
specific device. If you do not specify a device, the parameter will default 
to the disk or diskette having the volume serial number you specified on 
the VSN parameter. 
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data being added. If you specify NO (the default), the old information 
remains intact and the new data is added to the end of the file. If you 
specify YES, the original file contents are overwritten with the new data, 
but the original file characteristics are not preserved. (The only exception 
would be if the original! file had been created using the default values for 
all the file parameters.) INIT assumes the default values for all file 
parameters. To overwrite a file using the old file characteristics, use 
EXTEND=NO, not INIT. Otherwise, use INIT and specify your new file 
parameters. INIT applies only to MIRAM data files and tape files. 


teceaseaetceeiy 
BS Sn 
Dos ae 


Specifies whether the contents of a file are to be overwritten or merged 
with new data. If you take the default, YES, the existing file remains intact 
and the new data is added to the end. If you specify NO, the data is- 
overwritten, but the file characteristics are preserved. To overwrite a file 
using file characteristics, use the INIT=YES parameter instead of EXTEND. 
(The default values for EXTEND and INIT specify the same condition. The 
two parameters differ in how a file is overwritten with new data.) The 
EXTEND parameter is ignored if you specify INIT=YES. EXTEND applies 
only to MIRAM data files and tape files. 


oat 


Specifies the number of cylinders to be added to a file each time it 
requires more storage space. This parameter is specified only when you 
create a new file. The default is 1. 


, {CHG 


Specifies the starting (start-col-no) and ending (end-col-no) column 
positions of a key (i= 1-5). You may repeat this parameter for as many of 
the five keys as you have available to you when creating a file. DUP/NDUP 
specifies whether or not duplicate keys are allowed. CHG/NCHG specifies 
whether or not keys may be changed. 





nes 


KEYi={start-col-no:end-col-no 
iain 





SIZE=n 


Specifies the number of cylinders initially allocated for a file. You specify 
this parameter only when creating a new MIRAM file. 


~~ 


Specifies whether or not a MIRAM file should be created with a record 
control byte. If you specify YES, the file is created with a record control 
byte. If you specify NO or omit the keyword, it is not. 
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Specifies the record format of the file. If you want to write variable-length 
records, enter VAR. If you want to write fixed-length records, omit the 
keyword or enter FIX. 


RCSZ=n 


Specifies the record size used when writing a MIRAM data file to a disk or 
a format label diskette. The default is 256. 





this parameter only when writing to a file on a volume mounted on a 
selector channel device. The following are selector channel devices: 


8414 disk drive 
8425 disk drive 
8430 disk drive 
8433 disk drive 
NOTE: 
These devices are available only on Series 90 hardware. 


BFSZ=n 
Specifies the minimum |/O buffer size for the file you want to write to. 
Specifying a larger than minimum buffer size could reduce the number of 
disk I/O calls, causing your command to run faster. Not specifying a buffer 
size causes this parameter to default to a buffer size appropriate to the 
type of file you are writing to. 
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A typical example of writing a MIRAM file to disk is: 


MW FIL=LISTFILE,WR=LPM, VSN=D00029 , KEY 1=50:58 


This command writes the current work-space file to the file LISTFILE on disk 
volume DOOO29. The password LPM is supplied because the file was previously 
cataloged with it. Note that the file is written using the first key (i.e., the key 
specified in columns 50 through 58). 


NOTE: 


When EDT writes records from its work space, it strips them of trailing spaces. 
Therefore, whenever you're writing MIRAM data files with keys in the last columns 
of their records, be sure to do one of the following actions to prevent future data 
management errors: (1) don’t use keys that end in space, or (2) specify the 


STRIP=OFF parameter on the @SET directive so EDT won't strip records of trailing 
spaces. 


Format 3 


To write the current work-space file to a unit record file (i.e., to the printer, card 
punch, or to a data set label diskette), use this format: 


A@WRITE FILENAME=(filename ,VSN=volume 
'filename' 
‘'filename''! 
,DEVICE=(did 
DISKETTE 





PUNCH 


The help screen format ts: 


FELENAME 
MWRITE FILENAME=<'FILENAME' > ,VSN=VOLUME 
''FILENAME'' 
DID FIX 
,DEVICE=<DISKETTE> [,RCFM=< >] [,RCSZ=N] 
PRINT VAR 


PUNCH 
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e where: 


FILENAME= (filename 
item | 
''filename!! 

Specifies the name of the file to be written. The filename is the LBL name 
of the file and can be an existing LBL name, or, if you are creating the file 
now, you supply the LBL name with this parameter now. It can be from 1 
to 44 alphanumeric characters. The file name must be enclosed in 
apostrophes or quotes when embedded spaces, commas, or parentheses 
are used in It. 


VSN=volume 

Specifies the volume serial number of the media where the specified file is 
to be written. The number can be from one to six alphanumeric 
characters. This parameter is required for diskette unless you don't know 
the vsn of the diskette. In that case, you can use the DEVICE parameter 
instead. Neither the VSN nor the DEVICE parameter is required if you've 
cataloged the unit record file you want EDT to write its work-space 
contents to. 


DEVICE=(did 
DISKETTE 


Specifies the device you want to write to. did specifies the device address 
(did) of the device you want to use. The first digit is the channel number; 
the second and third specify the hardware address. The other choices, 
DISKETTE, PRINT, and PUNCH, specify the type of device to be used, but 
net a specific device. This parameter is required for the printer or the 
punch. If your unit record file is on diskette and you specified the VSN 
parameter, you do not have to specify the DEVICE parameter. Neither the 
VSN nor the DEVICE parameter is required if you've catalogued the unit 
record file you want EDT to write its work-space contents to. 


vA 


Specifies the record format of the file. If you want to write variable-length 
records, enter VAR. If you want to write fixed-length records, omit the 
keyword or enter FIX. 





RESZ=n 


Specifies the record size used when writing a unit record file to the 
printer, card punch, or a data set label diskette. The default value for this 
parameter depends on the type of device used. The default value for a 
printer is 132 bytes, the default for card punch is 80 bytes, and the 
default for data set label diskettes is 128 bytes. 
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A typical example of writing a unit record file is: @ 


dW FILE='NEW ACCOUNTS! ,DEV=PR 


This command writes the current work-space file to the printer. 
Format 4 
To write the current work-space file to a tape, use this format: 
@WRITE FILENAME= {filename [, WRPASS=password] 


'fiylename'! 
‘'fjilename''! 





laid! 1 panes ,BKNO=fY 
TAPE 86 
7RCEM=(BERGME YC, RCSZ=n] |, INIT 
FIXBL 





VARUNB 
VARBLK 
UNDEF 


The help screen format ts: ; 


FILENAME 
QWRITE FILENAME=<'FILENAME' > [,WRPASS=PASSWORD] 
‘'FILENAME'' 


FIXUNB 
DID YES FIXBLK 


»VSN=VOLUME ,DEVICE=< > [,BFSZ=N] ({,BKNO=< >] [,RCFM=<VARUNB>] [,RCSZ=N] 
TAPE NO VARBLK 
UNDEF 


YES YES 
(, INIT=< >] ([,EXTEND=< >) 
NO NO 
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where: 


'filename' 

''filename'! 
Specifies the name of the file to be written. The file name is the LBL name 
of the file and can be an existing LBL name, or, if you are creating the file 
now, you supply the LBL name with this parameter now. It can be from 1 
to 44 alphanumeric characters. The file name must be enclosed in 
apostrophes or quotes when embedded spaces, commas, or parentheses 
are used in It. 


ee oo | 


WRPASS=password 


Specifies a write password that restricts access to a file. The password is 
required only if a password entry for the file already exists in the system 
file catalog. The password can be from one to _ six alphanumeric 
characters. 


VSN=volume 
Specifies the volume serial number of the media where the specified file is 
to be written. The number can be from one to six alphanumeric 
characters. You must specify this parameter unless you previously entered 
the file in the system file catalog. If you don’t know the vsn of the tape, 
you can specify the DEVICE parameter instead. 


cis 
TAPE 


Specifies the device you want to write to. did specifies the device address 
(did) of the tape you want to use. The first digit is the channel number; 
the second and third specify the hardware address. TAPE specifies that 
you want to write to a tape; however, you don't have to specify a specific 


tape. 

BFSZ=n 
Specifies the block size of the tape for |/O operations. The default is 256 
bytes. Specifying a larger block size could reduce the number of disk I/O 
calls, causing your command to process faster. You would specify a block 
size different from the default when, for example, your command called for 
a block size other than 256. 

— YE: 





Specifies whether or not block numbers are created on the tape when the 
file is written. If you specify YES, block numbers are created on the tape. 
lf you specify NO, they are not. 
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IXBLK 
VARUNB 
VARBLK 
UNDEF 

Specifies the record format of the file. For descriptions of these record 
formats, refer to the consolidated data management concepts and 
facilities. 





RCSZ=n 


Specifies the record size used when writing a file to tape. The default is 
256 bytes. Specify this parameter only if the RCFM parameter equals 
FIXUNB or FIXBLK. 






Specifies whether the contents of a file are to be overwritten with new 
data being added. If you specify NO (the default), the old information 
remains intact and the new data is added to the end of the file. If you 
specify YES, the original file contents are overwritten with the new data, 
but the original file characteristics are not preserved. (The only exception 
would be if the original file had been created by using the default values 
for all the file parameters.) INIT assumes the default values for all files 
parameters. To overwrite a file by using the old file characteristics, use 
EXTEND=NO, not INIT. Otherwise, use INIT and specify your new file 
parameters. INIT applies only to MIRAM data files and tape files. 


sal beat 


NO 
Specifies whether the contents of a file are to be either overwritten or 
merged with new data. If you take the default YES, the existing file 
remains intact and the new data is added to the end. If you specify NO, 
the data is overwritten, but the file characteristics are preserved. To 
overwrite a file by using file characteristics, use the INIT=YES parameter 
instead of EXTEND. (The default values for EXTEND and INIT specify the 
same condition. The two parameters differ in how a file is overwritten 
with new data.) The EXTEND parameter is ignored if you _ specify 
INIT=YES. EXTEND applies only to MIRAM data files and tape files. 





A typical example of writing a file to tape is: 


MW FIL='"'SALE.ITEMS'', VSN=S00071,DEV=TA 


This command writes the current work-space file to the file SALE.JTEMS on tape 
volume S0007 1. 
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Format 5 
To write the current work-space file to the spool file, use this format: 


Q@WRITE [JOB=jobname] ik \ 





YES 
,EILENAME=/{ filename [,ACCT=acct-no] 
'filename' 
‘'filename'' 
, QUEUE=(PRINT) [, COPIES={n 
PUNCH q 
RDR 


The help screen format is: 


N FILENAME 
QWRITE [,JOB=JOBNAME} [,HOLD=< >] [,FILENAME=<'FILENAME' >] [,ACCT=ACCT-NO] 
Y ''FILENAME'' 


PRINT N 
{,QUEUE=<PUNCH>] [,COPIES=< >] 
RDR 1 





where: 


JOB=j obname 


Specifies the name of the job that produced the spool file. 


OLD={NO 
YES 


Specifies whether or not EDT writes the spool file in a HOLD state. If you 
want the file created in a HOLD state, enter HOLD=Y; if you do not want 
the file created in a HOLD state, enter HOLD=N. If you specify HOLD=Y, 
the file will not be printed or punched. If you specify QUEUE=RDR, EDT 
forces the HOLD option to NO. 


> 


FILENAME= {filename 
'filename' 
''filename!'! 

Specifies the logical file name of the spool file and must be the LBL name 
from your job control or the job name concatenated with the LFD name. It 
can be from 1 to 17 alphanumeric characters. The file name must be 
enclosed in apostrophes or quotes whenever embedded spaces, commas, 
or parentheses are used in it. 
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ACCT=acct-no 
Specifies the account number of the job that produced the spool file you 
want to write. The account number may be from one to four alphanumeric 
characters. It’s always optional. 


PUNCH 

RDR 
indicates the spool queue you want to write your file to. You may enter 
PRINT, PUNCH, or RDR. PRINT indicates that the file is written to the 
printer queue. PUNCH indicates the file is written to the card punch queue. 
RDR indicates that the file is written to the card reader queue. The card 
reader queue in this case acts as a virtual card reader. 


feo 





= 


Specifies the number of copies to be made of the spool file you want to 
process (where n = 1 to 255). The default is 1. This parameter is valid 
only when QUEVE=PRINT or QUEUE=PUNCH. 


A typical example of writing a file to the spool file is: 


aW FIL=PAYFILE,Q=PR,COP=2 


This command writes the current work-space file to the file PAYFILE residing on 
the printer queue of the spool file. This example specifies that EDT print two copies 
of the file when the output writer spools it out. 

Format 6 


To write to the same module or file last accessed through a previous @READ or 
(@WRITE command, use this format: | 


aWRITE 


NOTE: 


There is no help screen for format 6 of the WRITE command. 
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For example, let's say you update a module after reading it into EDT’s work space 
with the command, @READ MO=MYMOD,FIL=MYFIL,VSN=RELO80. After you 
make the necessary changes to the file, instead of including the three parameters 
on your @WRITE command, you simply key in @WRITE and EDT writes your 
module back to the module and file it came from. 


Format 7 
To write to the same module or file last accessed through a previous @READ or 
(@WRITE command but written to now with any valid EDT command specified, use 
this format: 


Q@WRITEA;Avalid EDT command 


NOTE: 


There is no help screen for format 7 of the WAITE command. 


where: 


Specifies the same file parameters, with the exception of KEY, KKEY, and 
SHOW, used in the most recent @READ or @WRITE command. 


valid EDT command 
Specifies any valid EDT command that you want to combine with the 
WRITE command. Table 3-2 lists the valid commands that you can 
combine with the WRITE command. 


For example: 
Q@WRITE ; CHANGE 'ABC' TO ‘DEF! 
Writes the file in EDT’s work space to the same module or file specified in the 


previous READ or WRITE command and changes all occurrences of ABC in the file 
to DEF. 
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Some typical examples of using WRITE combined with other commands are: 


@W FIL=*‘REPORT 9°’, VSN+=DO0031 C ALL ‘1980’ TO ‘1981"’ 
Writes the current work-space file to the file REPORT 9 on disk volume DOOO31 after changing every occurrence of 
1980 to 1981. Note that ALL is not a parameter associated with the WRITE command, but is an EDT modifier, 


which we explain in Section 4. 


@W MO=MYPROG,TY =P,FIL=MYFILE,VSN=DOO0034 INSERT ‘//’ 
Inserts two slashes (in columns 1 and 2) on every line in the current work-space file and then writes the current 
work-space file as the procedure MYPROG to the file MYFILE on disk volume DOOO34 
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3.19. COMBINING COMMANDS 
As mentioned earlier, more than one command can be used in a single command line. 


Table 3—2 shows you which command combinations are valid, which are not allowed, 
and which are ignored by EDT because they are redundant. 


Table 3~2. Command Combinations 


ncHoreanngn 
aed Zz-7207 
mozmcecoma| 


corr _| 
neers 


omen | 


UPDATE | 


WRITE 





LEGEND: 
R Redundant combinations 
N invalid combinations 





Valid combinations 
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4. Command Modifiers 


4.1. INTRODUCTION 


This section describes the EDT command modifiers. EDT command modifiers are 
1-word modifiers that are used in combination with the EDT commands to enhance or 
restrict their performances. These modifiers allow you to execute EDT commands 
against strings, lines, or columns other than those implicitly specified in the basic EDT 
commands, or those without any modifiers specified. 


Command modifiers must always be used with the EDT commands. They can't be used 
alone or with the EDT procedure file commands or directives. Not all EDT command 
modifiers can be used with every EDT command. For your convenience, the valid 
command and command modifier combinations are listed in Table 4-1. 
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Table 4—171. Valid Command Modifiers 





aetatattetateae 





CHANGE | 


om | 


DELETE 


mo | 
now | 
ro | 


SEQUENCE 
UPDATE 




























Valid combinations 
Invalid combinations 
Required combinations 


Unnecessary combinations, but valid 





The following subsections contain detailed descriptions of the command modifiers 
available. These modifiers are presented in alphabetic sequence. 
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4.2. ALL 

The ALL modifier repeats the action performed by a command throughout the implied 
or specified column range of each line in the work-space file that is processed. ALL is 
generally used in commands that act upon specified strings in the work-space file. 


The help screen format is: 


SYNTAX: @A[LL] 





A typical example of using ALL is: 


@CHANGE A ‘OLD’ TO ‘NEW’ 
Changes every occurrence of OLD to NEW on each line in the current work-space file. Without ALL, the command 
changes only the first occurrence on each line. 
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4.3. BY 


The BY command modifier specifies the increment to be used for sequence numbers 
inserted into input lines or existing lines in your current work-space file. BY is used only 
with the NUMBER and SEQUENCE commands and is required when using a sequence 
string. 


The help screen format is: 


SYNTAX: B[Y] 


Some typical examples of using BY are: 


@SEO ‘SU10’ BY 2 
Overlays columns 1 through 4 on the first line of the current work-space file with the sequence string SU10 and 
overlays columns 1 through 4 on subsequent (existing) lines in increments of 2 of that string 


@NU 'X125° BY 25 


Inserts sequence numbers into input lines, starting with the sequence string X125 and incrementing it by 25 
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COL 


4.4. COLUMN 


The COLUMN modifier specifies the column range on which the command it is 
combined with is to act upon for each line of a file. COLUMN is used to limit the search 
operation and guarantees that the search string begins somewhere within the column 
limits specified. 


The help screen format is: 


SYNTAX: COL[UMN] <COLUMN-RANGE> 





Some typical examples of the COLUMN modifier are: 


@COL 5 INSERT ‘=’ 


Inserts an equals sign in column 5 of every line in the current work-space file. Without COLUMN, this command 
inserts an equals sign in column 1 of every line. 


@COL 70:80 CHANGE ALL ‘MONTH’ TO ‘YEAR’ 


Changes every occurrence of MONTH to YEAR in columns 70 through 80 only on every line in the current 
work-space file. Without COLUMN, this command changes every occurrence of MONTH to YEAR on every line no 
matter where it appears. 


@COL 10,12,14 DELETE ‘%’ 


Deletes every line in the current work-space file that contains a percent sign in columns 10, 12, or 14. Without 
COLUMN, the command deletes every line in the current work-space file that contains a percent sign in any 
column. 


NOTE: 


When more than one column range is specified, columns must be listed in ascending 
order (7, 14, 28, 35). 
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4.5. FIRST 

The FIRST modifier directs EDT to stop processing the command it is combined with 
after the first line specified (implicitly or explicitly) in the command is completely 
processed. 


The help screen format is: 


SYNTAX: F[LIRST] 





Some typical examples of using FIRST are: 


@PRINT F ‘STREET’ 
Displays only the first line containing STREET. Without FIRST, it displays every line containing STREET. 


@CHANGE F ‘EDT’ TO ‘EDITOR’ 
Changes the first occurrence of EDT to EDITOR on the first line it appears on in the current work-space file. 
Without FIRST, the first occurrence of EDT on every line in the current work-space file is changed to EDITOR. 
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NOT 


4.6. NOT 


The NOT modifier executes the command it’s combined with on all lines in the current 
work-space file that don't contain a specified string. 


The help screen format is: 


SYNTAX: NOT 


Some typical examples of NOT are: 


@PRINT NOT ‘MAIN’ 


Displays ali lines in the current work-space file that do not contain MAIN. Without NOT, the command displays all 
the lines that contain MAIN. 


@COPY NOT ‘GROUP’ TO 50 


Copies all lines (in the current work-space file) that do not contain GROUP to lines 50, 51, 52, etc. Without NOT, 
this command copies all the lines containing GROUP to lines 50, 51, 52, etc. 


@DELETE NOT ‘APPLE’ 


Deletes all lines that do not contain APPLE in the current work-space file. Without NOT, the command deletes all 
lines containing APPLE. 


NOTE: 


The NOT modifier can't be used when a change string is specified. 








UP-8828 Rev. 2 SPERRY UNIVAC OS/3 4-8 
GENERAL EDITOR (EDT) 


4.7. ON 


The ON modifier specifies the line range on which the command it is combined with is 
to act upon. 


The help screen format is: 


SYNTAX: O[N] <LINE-RANGE> [,<LINE-RANGE>[,...]] 





Some typical examples of ON are: 


@O 4,7 INSERT ‘//’ 
Inserts two slashes beginning in column 1 on lines 4 and 7 of the current work-space file. Without ON, the 
command inserts two slashes beginning in column 1 on every line in the current work-space file. 


@O 20:30 CHANGE ALL ‘DUE’ TO ‘PAID’ 
Changes every occurrence of DUE to PAID on lines 20 through 30 only of the current work-space file. Without ON, 
the command changes every occurrence of DUE to PAID in the current work-space file. 


@O 5:8 SEQ ‘10’ BY 2 

Overlays columns 1 and 2 on lines 5 through 8 of the current work-space file with sequence strings. The sequence 
string 10 overlays columns 1 and 2 of line 5, and increments of 2 of that string (12,14,16, etc) overlay columns 1 
and 2 of subsequent lines in the specified line range (5:8). 


NOTE: 


When more than one line range is specified, lines must be listed in ascending order. 
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@ | SH 


4.8. SHOW 


The SHOW modifier specifies the column range for the READ, WRITE, INPUT, LIST, 
PRINT, and PUNCH commands. SHOW used with LIST, PRINT, or PUNCH specifies 
which columns of the current work-space file are to be printed, displayed, or punched. 
SHOW used with the READ and INPUT commands causes partial records to be placed 
in the work-space file, and SHOW used with the WRITE command causes partial 
records to be written to a program library or data file. The SHOW command causes 
left-justification of data to column 1 and blank padding to the right to fill the record. 


The help screen format is: 


SYNTAX: SH[OW] <COLUMN-RANGE> [,<COLUMN-RANGE>[,...]] 





e Some examples of SHOW are: 


@PRINT ‘RON’ COL 10:12 SH 65:70 

Displays columns 65 through 70 of all lines in the current work-space file that contain RON in columns 10 through 
12. Without SHOW, all lines in the current work-space file that contain RON in columns 10 through 12 are 
displayed in their entirety. 


@READ FIL=MYFILE, VSN=DO0029 SH 9:80 


Reads the records in the file MYFILE, which resides on disk volume DOO029, deletes columns 1 through 8 of each 
record, and then places the partial records in the work-space file using the current line number and increment. 
Because columns 1 through 8 are deleted from the records, each record is shifted eight columns to the left when 
it's entered in the work-space file, leaving columns 72 through 80 blank. The partial records now begin in column 
1 instead of column 8. Without SHOW, whole records are read into the work-space file. 


@WARITE FIL=‘FILE 6°, VSN=DO0029 SH 11:50 


Writes columns 11 through 50 of each line in the work-space file to the file ‘FILE 6’ on disk volume DOOO29. 
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4.9. TO 

The TO modifier specifies either the line destinations for moved or copied lines or a 
change string to replace a search string. TO is required in the MOVE, COPY, and 
CHANGE commands. 


The help screen format is: 


SYNTAX: T[O] 


Some examples of TO are: 


@MOVE 1T 5 


Moves line 1 to line 5 


@COPY 2 T 75 


Copies line 2 to line 75 


@CHANGE ‘APRIL’ T ‘MAY’ 


Changes the first occurrence of APRIL on every line in the current work-space file to MAY 
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5. EDT Procedure Files 


5.1. INTRODUCTION 


EDT enables you to divide the EDT work-space file into a maximum of 10 subfiles 
(procedure files) as shown in Figure 5-1. Notice that there is a main work file (the 
work-space file you are already familiar with) and nine other procedure files. 


PROCEDURE FILE 9 





Figure 5-1. EDT Work-Space File 


EDT procedure files are basically like the main work file; they consist of data and/or EDT 
commands. However, unlike the main work file, EDT procedure files can be executed. The 
commands or data entered in them can be executed against the main work file or any of 
the other defined procedure files. 
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Initially, all EDT procedure files are empty and you may create or update them any time 
during an EDT session. Every time a new EDT procedure file is created, EDT assigns the 
line number 1 to the first line of the procedure file and increments subsequent line 
numbers by 1. As many command lines or data lines as desired can be read or keyed in to 
define an EDT procedure file. However, if you want to enter a command line as text (a 
command that is to be executed when the procedure file is executed), it must be preceded 
by a double at sign (@@), which indicates that the entry is text. This prevents lines that 
contain commands from being executed as they are keyed in. 


EDT procedure files don’t have to be executed. They can be used independently of each 
other to create, edit, and update multiple files concurrently during an EDT session. Up 
to 10 files can be located in the work space at one time. 


The following subsections explain how to use EDT procedure files and explain the 
commands used to create, manipulate, or execute EDT procedure files. For your 
convenience, the EDT procedure file commands are summarized in Table 5-1. 


Table 5—7. Procedure File Commands 


a 


|NOP Permits extra line numbers and comments to be inserted into a procedure file 
PROC Begins procedure file definition 
RETURN 







Terminates procedure file execution 
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DO 


5.2. EXECUTING A PROCEDURE FILE (@DO) 


The DO command executes an EDT procedure file. The format is: 


@DO proc-number | {PRINT 
NOPRINT 
REVERT 


The help screen format is: 


SYNTAX: @DO <PROC-NUMBER> [P[CRINT]/N[COPRINT]/R{EVERT]] 





where: 


proc-number 
Specifies which EDT procedure file is to be executed. It is a single digit integer 
from 1 to 9. 


PRINT 


Specifies each line of the EDT procedure file is to be displayed on the 
workstation screen before it is executed. 


NOPRINT 


specifies each line of the EDT procedure file is not to be displayed before it is 
executed. 


REVERT 


Sets the print status to the state it was in (either PRINT or NOPRINT) when the 
current procedure file was entered. 


lf PRINT, NOPRINT, or REVERT is not specified, the display of lines depends on whether 
or not the @DO is being issued from another EDT procedure file. If the @DO is issued 
from another EDT procedure file, the print option currently active in the calling EDT 
procedure file is used. If the @DO is issued from the main work file, NOPRINT is 
assumed. | 
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NOTE: 


You also can use the DO command to change the print status without executing a 
procedure file. Enter @DO and the appropriate print status and do not specify a 
proc-number. 


Here are some typical examples of the DO command: 


@DO 3 P 


Executes procedure file 3 and displays each line of that procedure file before it is processed 


@DO 7 N 


Executes procedure file 7 but does not display its lines before they are processed 


@DO P 


Turns on the line display process of the current procedure file 


NOTES: 


1. During the execution of an EDT procedure file, input is taken from that procedure 
file. This input is handled in the same way as if it was keyed in at the workstation. 


2. Once the execution of an EDT procedure file is completed, control is returned to 
the file that specified it. This file may be the main work file or any other detined 
EDT procedure file. The line following @DO in the file then becomes the current 
line. 


3. If you execute a procedure file that contains an @BLOCK screen command, you will 
get errors. 
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5.3. TERMINATING PROCEDURE FILE DEFINITION (@END) 
The END command ends procedure file definition. 
The format is: 


@ END 


The help screen format is: 


SYNTAX: @E[ND] 





@END marks an EDT procedure file as completely defined and returns control to the file 
containing the @PROC that specified it. This file may be the main work file or any of the 
defined EDT procedure files. The current line number is then set to the line number last 
displayed at the time the corresponding PROC command was issued (the line number of 
the line containing @PROC). 


NOTE: 


@END cannot be keyed in while in the main work file. 
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5.4. BRANCHING WITHIN A PROCEDURE FILE (@GOTO) 


The GOTO command causes a branch to another command line in an EDT procedure 
file. 


The format is: 


— 


Line 


The help screen format is: 


SYNTAX1: @G[OTO] <LINE-NUMBER> 


SYNTAX2: @G[OTO] <LABEL> 





where: 


Label 
Specifies by label the next line to be processed. 


Line 
Specifies by line number the next line to be processed. 


The following are examples of the GOTO command. 
If you want to branch to line 7 


7.O@00@PaQ(XYZ) PRINT 10:20 
you can do so by keying in either of the following commands: 
5.9000PaG XYZ 


Or 


5.9000raG 7 
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Or, for instance, if you want to branch to fine 35 


35.0000>a(SRW181) MOVE 40 TO 45 


you can use either of the following commands: 
15.9000>aG SRW181 
or 


15.9000PaG 35 


5-7 
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INP 


5.5. LOADING AND EXECUTING PROCEDURE FILES (@INPUT) 

The INPUT command permits user-written EDT procedure files to be loaded and 
executed in a single command. These EDT procedure files may be SAT or MIRAM 
library modules, or MIRAM program libraries or data files. 

The format is: 


@INPUT file-parameters| (PRINT 
NOPRINT 


REVERT 


The help screen format ts: 


SYNTAX: @INP[UT] [<FILE>/;] [P[RINT]/N[OPRINT]/R[EVERT} ] 





where: 


file-parameters 
Specifies those parameters needed to read a library module, program library, 
or data file into the EDT work-space file. These parameters are discussed in 
3.14 (the READ command). 


PRINT 


Specifies that each line of the EDT procedure file is to be displayed on the 
workstation screen before it is executed. 


NOPRINT 


Specifies that each line of the EDT procedure file is not to be displayed before 
it is executed. 


REVERT 


Sets the print status to the state it was in (either PRINT or NOPRINT) when the 
current procedure file was entered. 
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lf PRINT, NOPRINT, or REVERT is not specified, the display of lines depends on whether 
or not the INPUT command is being issued from another EDT procedure file. If the 
INPUT command is issued from another EDT procedure file, the print option currently 
active in the calling EDT procedure file is used. If the INPUT command is issued from 
the main work file, NOPRINT is assumed. 


When an INPUT command is issued, EDT creates a procedure file 10 in the EDT 
work-space file, loads the file to be executed into procedure file 10, and then executes 
it. The file remains in procedure file 10 until another INPUT command is issued, 
replacing it with a new file. 


NOTE: 


You can access procedure file 10 using the INPUT command only, not by using the 
normal procedure file commands. 


A typical example of the INPUT command is: 


@INP FIL=‘ACCT FILE’, VSN=DO00029 P 
Loads and executes the file ACCT FILE on volume DOO029 as an EDT procedure file (proc 10). Each line of the 
procedure file is displayed before it is executed because the PRINT option was specified. 
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NOP 


5.6. ENTERING EXTRA LINE NUMBERS AND COMMENTS (@NOP) 


The NOP (no-operation) command is used to enter extra lines for branching or to enter 
comments into EDT procedure files. 


The format is: 
@NOP[ comment] 


The help screen format is: 


SYNTAX: @NOP [<COMMENT> ] 





where: 
comment 
Specifies a comment line to be inserted on a line in an EDT procedure file. If 
the comment is omitted, an extra line number is inserted into the file for 
branching. 
A typical example of the NOP command is: 


5.OOOO@NOP THIS IS A COMMENT. 


Places the comment THIS IS A COMMENT on line 5 of the file. (The comment is not recognized as data.) 


NOTE: 


The NOP command may also be used in the main work file. 
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PRO 


5.7. DEFINING A PROCEDURE FILE (@PROC) 


The PROC command displays the number of the procedure file you are currently using 
or makes a procedure file available for you to use. 


The format is: 


@ PROC [ proc-number] 


The help screen format is: 


SYNTAX: @PRO[C] [<PROC-NUMBER> ] 





where: 


proc-number 
Is an integer from 1 to 9 that specifies the number of the EDT procedure file 
that is to be made available for use (as the current work-space file). When 
proc-number is omitted, the number of the current procedure file is displayed. 


Some typical examples of the PROC command are: 


@PRO 


Displays the number of the procedure file currently in use 


@PRO 9 


Makes procedure file 9 the current work-space file in the EDT session 


lf the procedure file you specify is empty, line 1.0000 is displayed on the workstation 
screen. You then key in data or a command to begin defining the file. However, if the 
procedure file was previously defined (it already contains lines), the first line number 
displayed is then the line number that was current the last time the file was accessed. 


NOTE: 


Commands keyed in after the PROC command is executed affect only the contents of 
the current EDT procedure file. They do not affect the contents of the main work file or 
other defined EDT procedure files. 
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RET 


5.8. TERMINATING PROCEDURE FILE EXECUTION (@RETURN) 


The RETURN command terminates the execution of the EDT procedure file in which it 
appears. 


The format is: 


@RETURN 


The help screen format is: 


SYNTAX: @RET[URN] 





When the execution of an EDT procedure file is terminated via the RETURN command, 
control is returned to the line following the DO command that specified the procedure 
file to be executed. 


5.9. USING EDT PROCEDURE FILES 


The following sample EDT session shows you how to create, save, access, and execute 
an EDT procedure file. We will use this procedure file to update a job control stream in 
the main work-space file. 


EDT SESSION 1....... Creating and Saving an EDT Procedure File 


EDT 
1.0000>a PROC 1 


Procedure File 1 


Wes res 
Sa 


Writes a copy of 4.0000>a W MYPROC,D000029 tt 


procedure file 1 to a 
permanent file 4.000@>a END 
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In this session we created an EDT procedure file (PROC 1). Then we saved the contents 
of PROC 1 (via the WRITE command) in the permanent file MYPROC on disk volume 
DOO0029. The shaded portion denotes our saved procedure file. Notice that only data 
lines (command lines preceded by a double at sign (@@)) are written to the permanent 
file. Note, too, that EDT deletes one of the two at signs before saving each line. This 
enables the command lines to be executed easily via the DO or INPUT commands when 
the procedure file is read back into the work-space file. 


EDT SESSION 2.......... Loading and Executing an EDT Procedure File 





.9000>// JOB PERSNL 

-9000>// DVC 50 

-9000>// VOL 0001 

.9900>// LBL DIALOGFILE 
-9000>// LFD DIALG1 

-9000>// DVC 206 

-9000>// LFD PRNTR 

-9000>// DVC 200 

-9000>// USE DP, DIALG1, PRNTR 
-9000>// LFD WRKSTN 
-000@>// EXEC PRGRM1 
-@900>0 PROC 3 


-900@>a READ FIL=MYPROC, 
VSN=D00029. 


-@000>a PRINT 


-0000>9 C 'DIALG1' TO ‘MYDLG1!' 
-90900>a C 'PRGRM1T' TO 'MYPRG1' 
.9000ra C 'DVC 50@' TO ‘'DVC 6@' 
-9000>0 END 
-9@00ra DO 3 
.9O0Ora P 
.9000r// JOB PERSNL 
.0000>// §YE 66 
-9OOOr / / 0004 
-9000r// LBL DIALOGFILE 
.0000>// LFD BYBLGt 
-OO0Or // 
-O9000r// 
-9OO0r / / 
-0000>// USE WR 
.90000>// LFD WRKSTITN 
-0000>// EXEC #¥PRE) 


Our job control stream 


Oo CO nN WO WF WNW NH = 


Reads a copy of MYPROC 
into procedure file 3 


= 
Ss 










—_ 
— 






























@ INP FIL=MYPROC, VSN=D000029 P 









da C 'DIALG1' TO 
ada C 'PRGRM1' TO 
aa C 'DVC 5@' TO 


'MYDLG1' 
‘MYPRG1' 
'DVC 60' 
































Ends procedure 
file definition 





Executes procedure file 3 

















Displays our 
updated job 
control stream 


Our updated job 
control stream 
















*You can also use the INPUT command to load and execute an EDT procedure instead of using READ and DO commands. 


In this session we updated a job control stream in our main work file by executing an- 
EDT procedure file against it. We loaded and executed a copy of the procedure file we 
created in session 1. Here, the shaded portions denote the changes made to our 
original job control stream after the procedure file was executed. If you had specified 
the single INPUT command, @INPFIL=MYPROC, VSN=DOOO29 P, EDT would've 
loaded and executed MYPROC without your having specified the PROC, READ, END, and 
DO commands. 
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6. EDT Variables 


6.1. INTRODUCTION 


EDT provides 10 EDT variables for use with the EDT procedure files. These variables 
are used to hold such values as line numbers, column numbers, and strings (of up to 50 
characters). They are written in the format #Gn (where n is an integer from O to Q). 
These variables give flexibility in structuring commands. 


Initially, all 10 EDT variables consist of null strings. However, values may be assigned 
to the EDT variables at any time before or during the execution of an EDT procedure 
file. 


Before executing a command, EDT scans the command line for an EDT variable (e.g., 
#Gn). If a valid EDT variable is found, the variable is replaced with Its string value and 
then the command is executed. Because the value of an EDT variable is placed in the 
command before it is executed, it is possible to assign any part of a valid EDT 
command to a variable. 


lf the symbol #G is to appear as data in the command line, it must be written ##G so 
as not to be confused with a variable symbol. 
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AS | © 


6.2. ASSIGNING VALUES TO EDT VARIABLES (@ASSIGN) 
The ASSIGN variable assigns values to EDT variables. 
The format is: 
@ ASSIGN Gn=/'string'{ «nj 
n(xty) 
n{ +m) 


Gm 
LENCn) 


The help screen format is: 














SYNTAX1: @AS[SIGN] GN=<STRING> 

SYNTAX2: @AS[SIGN] GN=<LINE-NUMBER>(<COLUMN -RANGE>) 
SYNTAX3: @AS[SIGN] GN=<ABSOULTE - VALUE -EXPRESSION> 
SYNTAX4: @AS[SIGN] GN=GM 

SYNTAX5: @AS[SIGN] GN=LEN(<LINE-NUMBER>) 








where: 

Gn 
Specifies the EDT variable, where n must be an integer from O to 9. 

‘string! 
Specifies a string to be assigned to an EDT variable. The string must be 
enclosed in apostrophes. Multiple copies of the string may be specified by 
using the string multiplication factor «n, where n is the number of times the 
string is multiplied. After multiplication, the product of the number of 
characters in the string being multiplied and the string multiplication factor 
can't exceed 50. 

n(x:y) 
Specifies the contents in columns x through y of line n to be assigned to an 
EDT variable. 

n[+m] 
Specifies a number to be assigned to an EDT variable. The number n alone or 
the number n plus or minus the number m is assigned to an EDT variable. & 


(Only the absolute values for the numbers are assigned.) 
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e en 


Specifies that the value assigned to the EDT variable Gm is also assigned to 
another EDT variable (Gn). m must be an integer from 0 to 9. 


LEN(n) 
specifies the length of a line to be assigned to an EDT variable. n is the 
work-space line number. 


some typical examples of the ASSIGN variable are: 


@A G1=‘ABCD' 
Assigns ABCD to the EDT variable G1 


@A Gb='#G1(2:3)' 
Assigns the contents of columns 2 through 3 of variable G1 to variable G5. If variable G1 contains BC in columns 
2 through 3, as shown in the first example, then G5 is assigned the value BC. 


@A G4= 12.5 (10:16) 


‘Assigns the contents in columns 10 through 16 of line 12.5 to the variable G4 


@A G7=1-5 

Assigns the number 4 (-5+1) to the variable G7. (Note that the absolute value of the number ( | -4 | ) is always 
used.) 

@A G9=G1 


Assigns the value that is assigned to the variable G1 to the variable G9. 


@A G2=LEN(12) 


Assigns the length of line 12 to the variable G2 
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DI 


6.3. DISPLAYING VALUES OF EDT VARIABLES (@DISPLAY) 


The DISPLAY variable command displays a specified string, number, or value of an EDT 
variable on the workstation screen. | 


The format is: 


@ DISPLAY /'string' [xn] 
n€xzy) 
n[+m] 
Gm 
LEN(n) 


The help screen format ts: 


SYNTAX1: @DI[SPLAY] <STRING> 
SYNTAX2: @DI[SPLAY] <LINE-NUMBER>(<COLUMN -RANGE>) 
SYNTAX3: @DI[SPLAY] <ABSOLUTE - VALUE-EXPRESSION> 


SYNTAX4: @DI[SPLAY] GN 
SYNTAX5: @DI[SPLAY] LEN(<LINE-NUMBER>) 





where: 

‘string’ 
Specifies a string to be displayed on the workstation screen. Multiple copies of 
the string may be specified by using the string multiplication factor «n, where n 
is the number of times the string is multiplied. After multiplication, the product 
of the number of characters in the string being multiplied and the string 
multiplication factor can’t exceed 50. 

n¢x:y) 
Specifies the contents of columns x through y of line n to be displayed. 

n[ +m] 


Specifies a number to be displayed on the workstation screen. The number n 
alone or the number n plus or minus the number m is displayed. (Only the 
absolute values for the numbers are displayed). 
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Gm 
® Specifies that the value assigned to the EDT variable Gm is to be displayed on 
the workstation screen. 


LEN(n) 
Specifies the length of a line to be displayed. n is the work-space line number. 


NOTE: 
All displays will be 50 characters or less in length. 
Some typical examples of the DISPLAY variable command are: 


@DI ‘ANN’ 


Displays the string ANN on the workstation screen 


@DI! 12.5(10:16) 


Displays the contents in columns 10 through 16 of line 12.5 on the workstation screen 


@DI 12+8 


Displays 20 on the workstation screen 


@DI LEN(25) 
® Displays the length of line 25 on the workstation screen 


@D! G9 


Displays the value assigned to the variable G9 on the workstation screen. For example, if the value assigned to the 
variable G9 is ‘CRACKERS’, when @Di #G9 is issued, CRACKERS is displayed on the screen. 


The DISPLAY variable command is useful when displaying the contents of an EDT 
variable at a certain point in a debugging session or to display some messages during 
the execution of a procedure file. It is also used to display or format a line without 
actually creating a data line in the work-space file. 
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IF 


6.4. BRANCHING ON CONDITION (@IF) 


The IF variable permits an EDT command or an EDT procedure file command to be 
executed based on some condition. @IF can be used in both the main work file and 
EDT procedure files. 


The formats are: 


@IF.condition.command 


Or 


@ IF expression relation expression command 


The help screen format is: 


SYNTAX1: @IF <CONDITION> <COMMAND> 


SYNTAX2: @IF <EXPRESSION> <RELATION> <EXPRESSION> <COMMAND> 





where: 
condition 
Defines the operands used to test the success of locating a search string in 
the last search command or an error in a previous command. The operands 
are: 
.T. for a successful search 
.F. for an unsuccessful search 
.E. for the existence of an error in a previous command. A test for errors 
causes the error indicator to be reset. This indicator can also be reset 
by @SET CLEAR. 
expression 


Defines an EDT variable expression. (See 6.2.) 











UP-8828 Rev. 2 SPERRY UNIVAC OS/3 6-7 
GENERAL EDITOR (EDT) 


@ relation 


Defines a relational operator. They are: 


less than 

greater than 

equal to 
= less than or equal to 
greater than or equal to 
> not equal to 


I VA 


AVA 
| 


command 
ls an EDT command or EDT procedure file command. 


The best way to explain the use of the IF variable is to show it in some examples: 


@CHANGE ‘RIGHT’ TO ‘WRONG’ 
@IF .F. CHANGE ‘WRONG’ TO ‘RIGHT’ 


The IF command tests whether the search string RIGHT was located. If it was not located, then the command 
@CHANGE ‘WRONG’ TO ‘RIGHT’ is executed. 


@IF #G6 > = 25 PRINT ‘ACCOUNT 


Directs EDT to display all the lines containing ACCOUNT if the value assigned to the variable G6 is greater than or 
equal to 25 


@ @IF #G4 < > 9 ASSIGN G4=9 


Directs EDT to assign 9 to the variable #G4 if it is not already assigned to it 
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6.5. USING EDT VARIABLES 


Using EDT variables increases flexibility and efficiency of the commands associated with 
them. 


The following examples will give you some ideas as to how you can use the EDT 
variables to your advantage. Assume these values for the variables: 


@ ASSIGN G1=1 

@ ASSIGN G2=5 

@ ASSIGN G3='SEARCH' 

@ ASSIGN G4=G1 + G2 

@ ASSIGN G5='COL #G2 INSERT ‘«! ' 


@DELETE #G3 
Deletes all lines that contain SEARCH (#G3) 


@ON #61:#G4 PRINT #G3 
Displays all lines from line 1 (#G1) through line 6 (#G4) that contain SEARCH (#G3) 


@ON #G2 COL #G1:4#G4 CHANGE ‘#G3’ TO ‘LOCATE’ 
Changes SEARCH (#G3) to LOCATE in columns 1 (#G1) through 6 (#G4) on line 5 (#G2) 


@ON 1:20 #G5 


Executes the command COL #G2 INSERT ‘*’ (#G5) against lines 1 through 20. Specifically, it inserts an asterisk in 
column 5 (#G2) on lines 1 through 20. 


You can also use the EDT variables to specify a portion of a string. 
For instance, if 


#G/7 = 'ALPHABET' 


you could specify the ALPHA portion of the string by keying in the column range it 
occupies after the variable, like this: 


#G67(1:5) 


NOTE: 


lf the specified ending column is greater than the actual length of the variable, blanks 
are appended to the right side as needed: 


#67(6:12) = 'BET ' 
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7. Directives 


7.1. INTRODUCTION 


Another set of commands known as the EDT directive commands are also available to 
you. They serve as the interface between you, EDT, and the operating system. These 
are the commands that enable you to execute commands, access specialized language 
editors, and terminate EDT. They are also used to instruct EDT to adjust defaulted 
parameters. The directives CHECK, COBOL, DROP, EFP, FORMAT, HALT, RPG, SET, and 
SYSTEM are described in the following subsections. 
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CHE 


7.2. DISPLAYING PROCESSED LINES ON THE WORKSTATION (@CHECK) 


The CHECK directive determines if lines processed as a result of an EDT command are 
to be displayed on the workstation screen. 


The format is: 


@ CHECK feet \ 


The help screen format is: 


SYNTAX: @CHE[CK] [ON/OFF] NO OPERAND = ON 





where: 





Specifies that the processed lines are to be displayed. 


OFF 
Specifies that the processed lines are not to be displayed. 


If you issue an @CHECK=ON directive, EDT displays the lines processed as a result of 
another EDT command according to your specification for the SCRDSPLY parameter on 
the @SET directive. If SCRDSPLY=TRUNCATE, EDT displays one record per one screen 
line and truncates lines if necessary; if SCRDSPLY=FOLD, EDT displays one record per 
two screen lines and doesn't truncate lines. 

After EDT prints a full screen or the last screen, you have four options: 

1. you may update the displayed lines and transmit them to the EDT work space; 


2. you may continue the display of processed lines by pressing the F19 function key; 


3. you may prevent the display of processed lines by pressing function key F1 or F18; 
or 


4. you may terminate the @CHECK=ON directive by pressing the F2 function key. 





7 
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For more information on the use of these and other function keys, see Section 9 and 
the interactive services commands and facilities user guide/programmer reference. 


Here is a typical example of the CHECK directive: 
If the work-space file contained the following data lines 


1.0000 BEAR 
2.0000 CAT 
3.0000 ELEPHANT 
4.0000 CAT 


and the following commands were issued 


5.9000>QCHE ON 
5.@O0@>aQCHANGE ‘CAT' TO ‘LION! 


these lines would be displayed on the workstation 


2.90OO>LION 
4.0000>LION 
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COB 


7.3. ACTIVATING THE COBOL EDITOR (@COBOL) 

The COBOL directive activates the COBOL editor (assuming your system is configured 
with a COBOL editor) to create and maintain ANSI ‘74 COBOL source modules. During 
an EDT session, you activate the COBOL editor by keying in the following directive: 


a COBOL 


The help screen format is: 


SYNTAX: @COBLOL] [<PARAM-STRING>] 





If you aren't currently in an EDT session, to activate the COBOL editor you must first 
key in EDT to activate EDT and then follow that command with the COBOL directive: 


EDTA@COBOL 


lf you are already using the RPG Il editor, end your RPG Il session before activating the 
COBOL editor. 


For further information about the COBOL directive, see the COBOL editor user 
guide/programmer reference. 
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DR 


7.4. DELETING THE CONTENTS OF THE EDT WORK-SPACE FILE (@DROP) 


The DROP directive deletes all lines in the entire EDT work-space file (i.e., the main 
work file and all defined EDT procedure files). 


The format is: 


DROP 


NOTE: 


The difference between the DROP directive and the DELETE command is that @DROP 
deletes all lines in the entire work-space file, whereas (@DELETE deletes only the lines in 
the current work-space file (i.e., the file you are currently using). 


The help screen format is: 


SYNTAX: @DR[OP] 
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EFP 


7.5. ACTIVATING THE ERROR FILE PROCESSOR (@EFP) 

The EFP directive activates the error file processor so that you can correct your source 
code without waiting for your language processor to provide its output listing. During an 
EDT session, you activate the error file processor by keying in the following directive: 


aEFP 


The help screen format is: 


SYNTAX: @MEF[P] [<PARAM-STRING>] 





If you aren't currently in an EDT session, to activate the error file processor you must 
first key in EDT to activate EDT and then follow that command with the EFP directive: 


EDTAQEFP 


For further information about error file processing, see Section 11 of this manual. 
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FORMAT 


7.6. INTERFACING WITH RPGEDT OR COBEDT (@FORMAT) 
Depending on the subeditor you're working with (RPGEDT or COBEDT), the @FORMAT 
directive has two functions. However, it is valid only when you're in a_ subeditor 
session. 
For RPGEDT, the @FORMAT directive lets you change the display format type and/or 
switch RPGEDT from update mode to create mode. For COBEDT, @FORMAT lets you 
return to COBEDT after you temporarily exited from COBEDT to EDT through the CMD 
continuation code during a COBEDT session. The formats for the @FORMAT directive 
are: 

@FORMAT parameter string (for RPGEDT) 
or 


a FORMAT (for COBEDT) 


The help screen format is: 


Syntax 1: @FORMAT <PARAM-STRING> FOR RPGEDT 


Syntax 2: @FORMAT FOR COBEDT 





For more information on the @FORMAT directive, see the appropriate subeditor manual. 











UP-8828 Rev. 2 SPERRY UNIVAC OS/3 7-7 
GENERAL EDITOR (EDT) 


7.7. TERMINATING EDT (@HALT) 


The HALT directive terminates the EDT session. It releases the work-space file (i.e., the 
main work file and all defined EDT procedure files). 


The format is: 


QHALT 


NOTES: 


1. If you haven't written the contents of the work-space file to a permanent file when 
(®@HALT is entered at the workstation, the message EDOO3 EDITED FILES NOT 
SAVED, TERMINATE (Y,N)? is displayed to remind you to do so. If you answer Y, 
EDT is terminated without saving the contents of your work-space file; however, If 
you answer N, the current work-space line number is displayed so that you can 


enter a WRITE command to save it. Once the file is saved, you reissue the HALT 
directive to terminate EDT. 


2. If you are using the error file processor and issue an @HALT directive, EDT first 
terminates the error file processor automatically, then terminates itself. 


The help screen format is: 


SYNTAX: @H{[ALT] 
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RPG 


7.8. ACTIVATING THE RPG I! EDITOR (@RPG) 

The RPG directive activates the RPG Il editor (assuming that your system is configured 
with an RPG Il editor) to create and maintain RPG II source modules. During an EDT 
session, you activate the RPG Ii editor by keying in the following directive: 


aRPG 


The help screen format is: 


SYNTAX: @RPG [<PARAM-STRING> } 





If you are not currently in an EDT session, to activate the RPG Il editor you must first 
key in EDT (to activate EDT) and then follow it with the RPG directive: 


EDTA@RPG 


lf you are already using the COBOL editor, end your COBOL editor session before 
activating the RPG Il editor. 


For further information about the RPG directive, see the RPG Il editor user 
guide/programmer reference. 
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7.9. SPECIFYING PARAMETERS TO EDT (@SET) 


The SET directive defines various parameters to EDT. Collectively, these parameters 
make up what we call your EDT environment. The format is: 





@ SET hetiquansnuettta Toten 





k EXCLUDE= —- —— one een ee 
[ 


, COLON=range-separator][ ,ENDCOL=end- EE 





—_—— {or 


ie SCRDSPLY {munca 
1-15 


,MODE=( LINE RECENTRY=(S 
SCREEN MULT 








liownrg 
COBOL 
RPG 





The help screen format is: 


SYNTAX: @SCET][<OPTION>(,<OPTION>[,..-]]] 
WHERE <OPTION> IS ANY OF THE FOLLOWING: 


C [HAR] =X TCABSJ=N[,N...] ULfINEJ=N ECXCLUDE]=X/OFF ALTSIGNJ=X 
CO[LLONJ=X EN[DCOL]=X BCUFFER]=N/OFF W{IDTHJ=N S{TRIP] =ON/OFF 
RO[LL]=N MCODEJ=LCINE]/SCCREEN) R[ECENTRYJSCINGLE) /M({ULT] 

SCC RDSPLYJ=T[RUNCATE}/F[OLD} SCRE [ORM] =UCUNDERLINE) /BELANK] 
LACNGUAGE]=F [REEFORM)/FO[{RTRAN] /C[OBOL]/R(PG] 





where: 


CHAR=tab-character, TABS= ‘— 





Specifies the character EDT uses as the tab key and the columns it uses as 
tab stops. To use tabs, you must specify both parameters, CHAR and TABS. 


You may specify CHAR= as any character on the workstation keyboard 
except your command trigger (@) and these predefined symbols: * & $ % ? [ ]. 
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When specifying TABS, you must separate the column numbers where you 
want tab stops with commas. And you can specify a maximum of eight stops. 
Note that TABS=OFF clears previously set stops. 


For example, CHAR=; assigns the semicolon as your tab key, while 
TABS= 10,30 sets your tab stops at columns 10 and 30. 


When you actually press your tab character while entering data, EDT does not 
move the cursor to the appropriate tab the way a typewriter does; however, in 
the future, whenever EDT displays that line on the workstation or prints a 
listing of it, it will be in the correct tab format you have designed. 


For example, assume your tab character and columns are those we just 
specified in the previous example. If you key in 


13.9000>USER1;SPERRY UNIVAC;BLUE BELL, PA 
in the future EDT will display line 13 as: 
43. 0000> USER SPERRY UNIVAC BLUE BELL, PA 
If you want to skip an entry under the first tab column, you key in 
13.900O0>USER1;;BLUE BELL, PA 
in the future EDT will display line 13 as: 


13.@00O>USER1 BLUE BELL, PA 


NOTE: 
The tab character is ignored during an @UPDATE process. 


LINE=length 


Specifies the maximum number of characters to be printed on a line at the 
workstation. The length may be from 1 to 2048 characters. For example, 
LINE=50 sets the maximum length for print lines to 50 characters. Note that if 
the length is omitted (LINE = ), the length of the lines is set to 128 
characters. 


TTT) ny 





seca aii 


Specifies a character used to mask other characters. An exclusion character 
may be either a letter from A to Z or an integer from O to 9. For example, to 
change the first three characters on lines 1 through 4 in the following example, 
establish X as the exclusion character (EXCLUDE= xX). Then change the masked 
characters with the command CHANGE ‘XXXDATA’ to ‘EMPDATA‘’. 
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© Lines 1 through 4 are changed to EMPDATA: 


.9900PaSET EX=X 

.999O>MSKDATA 

.9O900>LKTDATA 

-9OOO>RAMDATA 

.9®OO>PEHDATA 

-9O@@PACHANGE 'XXXDATA' TO '‘'EMPDATA!' PRINT 
.9900>EMPDATA 

.9O@O>EMPDATA 

. 99OO>EMPDATA 

. 999O>EMPDATA 


~ WN -| uw &F& WNW NY | — 


Note that if EXCLUDE=OFF is specified, no exclusion character is assigned. 


ATSIGN=command- trigger 


Defines the character to be recognized as the current command trigger. It is 
used to change the preset command trigger (@) to another character. The 
command trigger may be set to any character found on the workstation 
keyboard except for these predefined symbols: * & % $ ? [ and ]. For 


example, ATSIGN=# changes the command trigger to #. Therefore, an 
} executable EDT command would look like #COPY 1 to 5 instead of @COPY 1 
to 5. 


COLON=range-separator 


Defines a character to be recognized as the column and line range separator. It 
is used to change the preset range separator (:) to another character. The 
range separator may be set to any character found on the workstation 
keyboard except for these predefined symbols: * & % $ ? [ J]. For example, 
COLON=— makes the hyphen the range separator. Therefore, a line range 
would now look like 20—30 instead of 20:30. 


ENDCOL=end- column 


Defines the end column for a search operation (i.e., a command using a search 
String). It is used to change the end-column indicator (]) preset by a previous 
FIND command to another character. The end-column indicator may be set to 
any character found on the workstation keyboard except for these predefined 
symbols: * & $ % ? [. For example, ENDCOL=! sets the end-column indicator 
to an exclamation point. 


es 





Defines the maximum record size of a user record. The record size may be set 
in the range of 128 to 2048. The default is 128. BUFFER=OFF sets the buffer 

© size to 128. Note that in order to change the record size, the work space must 
be closed. You close the work-space file via the DROP command. 
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CLEAR 
Resets the error indicator. 


WIDTH=device-size 


Defines the output device size. The device size may be set in the range of 1 to 
2048. If an odd number is specified, the device size is automatically rounded 
to the next even number. The default values are 120 for batch mode and 960 
for interactive mode. 


sia 4 





Indicates whether data lines are to be stripped of trailing spaces and X‘O0O's. 
ON specifies that trailing spaces and X‘OO’'s are stripped. OFF specifies that 
they are to be retained. 


DISPLAY 


Displays the current status (values) of the SET command parameters. It’s the 
same as using the SET command without any parameters. 


ential sa CROSS sone etree le 
ar. SS q 
3 Se Oe Sg 
5. Ro Se Se 
watee tee 
SESS aioe a CAN Ra 


Specifies that you want to display or input either full-length character records 
(those containing 70 to 128 characters) or partial records (those containing 70 
characters or less). Your specification for this parameter determines the record 
length that EDT accepts or displays when you issue: 





= the EDT commands @BLOCK, @PRINT, or @ROLL; or 
@# the @CHECK=ON directive. 


SCRDSPLY=TRUNCATE specifies that you want EDT to truncate all lines that 
you enter, or that it displays, to /7O characters or less. This specification 
allows you to enter or display more records per screen than SCRDSPLY =FOLD 
because SCRDSPLY=TRUNCATE causes EDT to accept or display one screen 
line per one source or data line. 


SCRDSPLY=FOLD specifies that you don’t want EDT to truncate lines you 
enter, or that it displays, to 70 characters or less. When SCRDSPLY =FOLD, 
EDT displays and accepts 128 characters. This specification reduces the 
number of records per screen that EDT can display because SCRDSPLY =FOLD 
causes EDT to accept or display two screen lines fcr every single source or 
data line. 
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Specifies the number of lines EDT rolls forward when you issue an @ROLL 
screen command. See Section 8 for a description of the @ROLL screen 
command. 


Anytime you change your specification for the SCRDSPLY parameter, EDT 
automatically changes the value for ROLL if you dont change it yourself. 
Because SCRDSPLY=TRUNCATE allows EDT to display twice as many source 
or data lines per screen as SCRDSPLY=FOLD does, your value for ROLL when 
SCRDSPLY =TRUNCATE can always be approniugtey twice as much as your 
value for ROLL when SCRDSPLY =FOLD. 





MODE=( LINE 

SCREEN 
Specifies whether EDT operates in line or screen mode. See Section 10 for 
detailed information about screen mode processing. 


NOTE: 


The following three parameters apply only if you specified that you want EDT to 
operate in screen mode (MODE=SCREEN). For information on specifying them, see 





Section 10. 

LANGUAGE=/ €REEFORM 
FORTRAN 
COBOL 
RPG 


Identifies the type of formatted screen that EDT presents for entering source 
code or data in screen mode. 


aie a 





Identifies the number of lines you want to enter in one transmission. 


In” 
Im 
10 


BF SOOT wp AGEN ERR ECO 
F 0 R M E 8 = Se & : 
3 3 Sone i ,. 
WARES: Ss EEN SOSA 
ARES gies 





Defines whether or not EDT displays underlines to indicate fields you can fill in. 


It is not necessary to specify all the parameters with the SET directive. They may be 
specified alone, in combinations, or all at once. The SET directive may also be used 
without any parameters, in which case a listing of the values currently assigned to all 
the SET directive parameters is produced, as well as a display of the last used file 
string. 
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NOTE: 


Do not separate pararneters by spaces. When EDT encounters a space in the SET 
directive, it terminates the directive at that point. 


Some typical examples of using the SET directive are: 


@S C=/,T=12,24,36,48 
Sets the tab key to a slash and tab columns to 12, 24, 36, and 48. Thus, everytime a slash is keyed in, the data 
following it is shifted to the next tab stop (12, 24, 36, or 48 in this case). 


@S L=70 | 

Sets the maximum line length to 70 characters. Therefore, only the first 70 characters keyed in on a line will be 
displayed on the workstation. If a line longer than 70 characters is keyed in, the line is truncated after the last full 
word inside that 70-character boundary. 


@S A=/,CO=; ,EN=! 
Sets the command trigger to a slash (/), the range separator to a semicolon (;), and the end column indicator to an 
exclamation point (!) 


@S A=q, CO=i 
Sets the command trigger to q. Note that the range separator is not reset to i because EDT detects a space before 
CO=i, which terminates the command. 


@S M=S,LA=C,SC=F 


Activates screen mode processing for you to enter COBOL source code with no source lines truncated. 
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SY 


7.10. EXECUTING WORKSTATION COMMANDS DURING AN EDT SESSION 
(@SYSTEM) 


The SYSTEM directive permits workstation commands to be issued during an EDT 
session, or it returns you temporarily to system mode. The main work file and any 
defined EDT procedure files are retained. 


The format is: 


@ SYSTEM [ workstation-command] 


The help screen format is: 


SYNTAX: @SY[STEM] [<EXECUTIVE-COMMAND -STRING> ] 





where: 


workstation-command 
Specifies a workstation command (as defined in the interactive services 
commands and facilities user guide/programmer reference) that is to be keyed 
in during an EDT session. 


If you specify @SYSTEM without a workstation command specified, EDT temporarily 
returns you to system mode and displays a message telling you to enter a system 
command. In response to this message, key in the system command you want to enter 
at the start-of-entry character ([>) and press the XMIT key. When you have no other 
system commands to enter, key in RESUME at the start-of-entry character and press 
the XMIT key. Your system then returns control to EDT, which positions the cursor at 
the next available line to accept your next command or data. 


While your system processes the system commands you entered, you will see 
SYS MSG, for system message, displayed on the system state line. To see the 
message, press FUNCTION and SYSMODE simultaneously. You'll then see the message 
displayed on the top of your screen. Press the XMIT key after reading each message. 
When there are no more system messages, press the XMIT key once more and your 
system will reposition the cursor at the next available EDT line. 
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some typical examples of the SYSTEM directive are: @ 


@SY TELL 


Enables you to interrupt your EDT session to send messages to the system console operator 


@SY ASK 


Enables you to interrupt your EDT session to ask questions of the system console operator 


@SY 


Returns you temporarily to system mode without releasing the work-space file 
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8. Screen Commands 


8.1. INTRODUCTION 


The EDT screen commands display screens that make EDT easier to use. Although 
each command displays a different kind of screen to help you perform a different 
function, the screen commands have one thing in common: they all make EDT easier to 
use because they reduce the need for you to interrupt your EDT session to get 
information about your system, in general, and about EDT, specifically. In short, they 
help you conduct an entire EDT session without leaving your workstation screen. 


(The only screen command that doesn’t display a screen is the RESTORE command. 
This command's function is to return you to the point in your EDT session where you 
Issued another screen command. In this way, it too makes EDT easier to use.) 


Although these commands are called screen commands, there’s no reason for you to 
restrict their use to screen mode only. You can use all the screen commands in line or 
screen mode; in both modes, they provide the same functionality for you. Whatever 
mode you're in when you issue a screen command is the mode EDT returns you to 
after it processes the screen command. 


Each screen command has a function key equivalent. When pressed, the function key 
performs the exact same function as the command. See Section 9 for a description of 
function key use. 


Like all other EDT commands, you must precede all screen commands with an at sign 
(@). Once EDT processes the screen command you've entered, it displays a screen. 
Before pressing the XMIT key on any of these screens, be sure to move the cursor to 
the bottom rightmost position on the screen to ensure that EDT transmits all the 
information on the screen to the work-space file. 


The following subsections describe the EDT screen commands. They present the 
commands in alphabetical order for easy reference. For each command, we give a 
description of the command, the format for entering it, detailed information about how 
to use the command, and an example of its use. For your convenience, Table 8-1 
summarizes the screen commands. 
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NOTE: 


With the exception of the PROMPT screen command, all screen commands operate 
independently. Therefore, you can’t combine any of them with any other EDT 
commands, nor can you use modifiers with any screen command. 


Table 8-1. Screen Commands 


Oe 


BLOCK Displays a freeform screen that allows you to switch to block mode for entering multiple 
commands or data. 


| HELP } Displays help screens for any EDT error messages. help screens for any EDT error } Displays help screens for any EDT error messages. 


oo Displays a screen showing the parameters of the @SET directive (those that make up your EDT 
environment). 


PROMPT Displays the EDT command menu screen and help screens for any of the EDT commands 
(meaning EDT commands, modifiers, directives, procedure file commands, variables, and screen 
commands.) 


RESTORE Returns you to the point in your EDT session where you originally entered a screen command. 
ROLL Displays freeform screens, showing the EDT work-space file, where you can update lines or 
simply view them. 
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8.2. ENTERING MULTIPLE COMMANDS AND DATA (@BLOCK) 


The BLOCK screen command lets you switch to block mode from line or screen mode. 
In block mode, EDT displays a freeform screen so you can enter multiple EDT 
commands or data. The format of the BLOCK command is: 


ABLOCK 


The help screen format is: 


SYNTAX: @BL[OCK ] 





The function key equivalent for the BLOCK command is F4. Pressing F4 is the same as 
keying in the @BLOCK command. 


In block mode, you can enter one or more lines and can combine commands and data 
in one transmission. EDT processes the lines in the order you entered them and doesn't 
display another freeform screen until it processes all the lines in one transmission. 


EDT places data in the work space sequentially from the current line number, places 
embedded blank lines in the work space as blank lines, and ignores trailing blank lines. 


When working in block mode, you cannot enter any other screen commands except 
(@RESTORE and you can't use the directives @COBOL, @RPG, or @EFP. In addition, you 
can't use @BLOCK in an active procedure file. That is, if you execute a procedure file 
that contains @BLOCK, you will encounter errors. 


The maximum number of characters you can enter on one line of the block mode 
freeform screen depends on your specification for the SCRDSPLY parameter of the 
(@SET directive. If SCRDSPLY=TRUNCATE, you can enter a maximum of 70 characters 
on one line; if SCRDSPLY=FOLD, you can enter a maximum of 128 characters. 


When you enter block mode, the first line of the freeform screen contains the current 
line number. The rest of the lines are preceded by asterisks that EDT protects and 
removes when you press the XMIT key. You terminate block mode by pressing the F14 
function key. EDT then returns you to the mode you were in when you issued the 
(BLOCK command, at the point in your EDT session where you originally entered the 
(@BLOCK command. 
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The following is the block mode freeform screen that EDT displays when you enter 
block mode and your value for SCRDSPLY of the @SET directive is TRUNCATE: 































0S/3 EDT (V7.52) EDT BLOCK MODE TRUNCATE 


REMAKE EKCKKEKREREREREEKEEEREEKEEREKEREKEKREEEERUEREKEREKEEEERERRKEKREKREKEEEKREKKKKKEE 


nnnn.Annn 
KREKKKKKK 


KKRKKEKE 
TET Litt: 
kkk kkk kk 
tkkkkkhke 
ekKKKKERE 
te te te te ke te te tee 
Rk RKK KEKE 
KkKRREKEK 
kkk ktkikk 
Keke K 
thk tk tek 
wit tte ek 


KaKKKKKEKK 


FK14 - Return 
FTTH IRR EKER EER HIRE KEENER EEE REE EUEEREREKHE KKK 


ERROR MESSAGE AREA (2 Lines) 





On this one screen, you could, for example, issue an @CHANGE command to change a 
string already in your work-space file to a string you provide with the command. You 
could also issue an @INSERT command to insert a totally new string. Before you 
transmit those commands, you could issue an @PRINT command to have EDT display 
the changes on your workstation screen and an @LIST command to have EDT list its 
work-space contents on your printer. Then, in one transmission, EDT would process 
those commands one after another. To move the cursor to the next line without 
transmitting them, press the TAB FORWARD key. Your entries could look something 
like the following: 


@CHANGE 'BOB' TO ‘ROBERT! 
@INSERT "ABC! 

@PRINT 

@LIST 
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8.3. REQUESTING HELP WITH EDT ERROR MESSAGES (@HELP) 


The HELP screen command lets you display a help screen for any EDT error message. 
The format of the HELP command is: 


@HELP [error message code] 


The help screen format is: 


SYNTAX: @HE[{LP] [<EDT ERROR MESSAGE>] 





where: 


error message code 
Specifies the error message prefix and number that precedes every error 
message. For example, in error message 


EDO16 INVALID LINE SET COMMAND, 
EDO16 is the error message code. 


The function key equivalent for the HELP command is F6. Pressing F6 is the same as 
keying in the @HELP command with no error message code. 


lf you enter the HELP command with no error message code, EDT displays a help 
screen for the last EDT error encountered. On the other hand, if you specify an error 
message code on the HELP command, EDT shows the help screen only for that specific 
message. 


The error message help screen: 
= # shows the error message prefix, number, and text; 
™ gives an explanation of the error; and 


a includes a line for you to enter an EDT command to fix the error or reissue an 
improperly entered command, if possible. 


After EDT processes the command, EDT returns you to the point where you issued the 
HELP command. If you don’t want to enter an EDT command, simply press the XMIT 
key or the F14 function key to return to the point where you encountered the error and 
entered the HELP command. 
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Note that the EDT HELP command doesn't display help screens for messages other 
than EDT error messages. To get help for error messages from EDT’s subprocessors 
(the COBOL and RPG Il editors and the error file processor), or from other system 
components, enter system mode and issue an interactive services HELP command. See 
the @SYSTEM directive for the procedure for temporarily entering system mode during 
an EDT session. The interactive services commands and facilities manual gives a 
description of the interactive services HELP command. 


In some cases, EDT can't display a help screen for a message because EDT's error help 
screen file doesn't contain a help screen for that error message. In these cases, see the 
system messages manual for a description of your error and the corrective action you 
should take. 


The following is a sample EDT error message help screen: 


0S/3 EDT (V7.52) EDT ERROR HELP 
RHR REECE KEKE EREKKERKEAERRRKEKKEEEKEKEREEKEEREKEKEKRREKEREMEREK 

EDO016 INVALID LINE SET COMMAND 

An invalid tine number has been used with the line set 

command. A valid Line number has no more than 4 decimal 

digits on either side of the decimal point @ @ is not a 

valid command. 

FK14:- Return Transmit - EDT command 


EDT COMMAND :(@raaC DBE: 


RRM EKKKEKEEEKEKKKEEEKKEEKEREKCEREKEEEUKEMEREREKEEKKEEKRKEEEKTEKEEKKKEKKKKKEKRKKK 


ERROR MESSAGE AREA (2 Lines) 





To correct the error, you could reissue the @ command with a valid line number. For 
example, you'd specify a line number of no more than four digits on either side of the 
decimal point, say, 2.0010. (Your entry is shown as white letters on a_ black 
background on the sample screen.) EDT then sets the current work-space line number 
to that number and returns you to the point in your EDT session where it reported error 
EDO 16. 
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8.4. REVIEWING THE EDT ENVIRONMENT PARAMETERS (@PARAMS) 

The PARAMS screen command lets you request a screen showing all your current 
values for the parameters of the @SET directive. These parameters collectively make up 
what we call your EDT environment. The format of the PARAMS command is: 


@PARAMS 


The help screen format is: 


SYNTAX: @PA[RAMS] 





The function key equivalent of the PARAMS command is F3. Pressing F3 is the same 
as keying in the @PARAMS command. 


When EDT displays the environment screen, you can update any number of the @SET 
parameters. You do so by simply moving the cursor to the values you want to change, 
typing the new values over the current values, moving the cursor to the bottom 
rightmost position on the screen, and pressing the XMIT key. EDT then updates the 
@SET parameters and returns you to the point in your EDT session where you issued 
the @PARAMS command. The only difference in your EDT session, provided you 
changed any of the parameters, is that your environment will be different in whatever 
way you indicated through the changes to the @SET parameters. (Of course, you could 
also directly issue an @SET directive to change EDT environment parameters. But the 


PARAMS command lets you review your parameters first, then you can change them if 
you want to.} 


After reviewing your parameters, if you don't want to change any, simply press the F14 
function key and EDT returns you to the point in your EDT session where you issued 
the PARAMS command. in these cases, your environment doesn't change. 
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The following is a typical environment screen that EDT would display in response to a 
PARAMS command: 


OS/3 EOT (V7.52) EDT ENVIRONMENT 


REBECCA KKEERAEREEKEREREREKEKHEEEEEEEREREKREKEEKEREEUHEREREKEHEKKEKEKEREREHKKRKRKKK 


CHAR=; TABS=0010, 0016, 0040, 0073 
LINE=@128 EXCLUDE=OFF 

ATSIGN=@ COLON=: 

ENDCOL=] BUF FER=0128 

WIDTH=0960 STRIP=ON 

MODE=SCREEN LANGUAGE=FREEFORM 


RECENTRY=MULT SCRDSPLY=TRUNCATE 
ROLL=15 SCRFORM=UNDERLINE 
FK14 - RETURN TRANSMIT ~ UPDATE ENVIRONMENT 


EEARKKCWRKEEEEHERARERREEKAEEREKAEKHEREAKKCEEEKHEREREEREKREHKKKEEEEKEUEEREEKKEKEKKEEKK 


ERROR MESSAGE AREA (2 LINES) 
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8.5. DISPLAYING THE EDT COMMANDS AND THEIR HELP SCREENS 
(@PROMPT) 


The PROMPT screen command lets you display a menu screen showing all the EDT 
commands (meaning the EDT commands, modifiers, directives, procedure file 
commands, variables, screen commands, and function keys that you can use in EDT). It 
also lets you request a help screen for any of these commands. The format of the 
PROMPT command is: 


@PROMPTALedt command] 


The help screen format is: 


SYNTAX: @PROMEPT] [<EDT COMMAND>] 





where: 


edt command 
Specifies that you want to see a help screen for a specific EDT command. For 
example, @PROMPT NUMBER shows a help screen for the EDT NUMBER 
command. When requesting a specific help screen, you can use the full name 
of the EDT command or its abbreviation. 


The function key equivalent for the PROMPT command is F13. Pressing F13 is the same 
as keying in an @PROMPT command with no EDT command specified. 
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EDT command menu screen: 






OS/3 EDT (V7.52) EDT COMMAND MENU 
FoF FF IOI I He Be Fe FFI Ke eK HTT TH I TK TK KIKI IIH ITI TI RATT KERATIN I IK 









COMMANDS MODIFIERS DIRECTIVES 









(a) INSERT READ ALL ON CHECK HALT 
CHANGE LIST REMOVE BY NOT COBOL RPG 
COPY MOVE SEQUENCE COLUMN) SHOW EFP SET 
DELETE NUMBER UPDATE FIRST TO FORMAT SYSTEM 
FIND PRINT WRITE 

FSTATUS PUNCH FUNCTION KEYS 






FK1 - TERMINATE PRINT 
PROC FILE COMMANDS VARIABLE COMMANDS SCREEN CMDS FK2 - TERMINATE COMMAND 













DO INPUT ASSIGN PARAMS HELP FK3 - ENVIRONMENT MENU 
DROP NOP DISPLAY BLOCK PROMPT FK4 - BLOCK MODE 
END PROC IF RESTORE ROLL FKS - ROLL FORWARD 
GOTO RETURN FK6 - ERROR HELP 

FK13 - COMMAND MENU 
TRANSMIT - HELP, COMMAND FK14 - RETURN FK14 - RETURN 










HELP FOR WHICH EDT COMMAND: 
EDT COMMAND: 


PRA SALALESAEALELESLELLASAELALE SEE AS EELS AS LETS SET PRT PP eS Pe TP TP STC CPSP TCS eS eee rf 


ERROR MESSAGE AREA (2 Lines) 








From this command menu screen, you can do one of the following: 


= enter an EDT command by keying in the command after the EDT COMMAND: 


message and pressing the XMIT key; 


m request to see a help screen for a specific EDT command by keying in the 
command after the message, HELP FOR WHICH EDT COMMAND:, and pressing the 
XMIT key (note that you can also display a help screen by including a specific 


command in your PROMPT command); or 


= return to your EDT session at the point where you originally entered the PROMPT 


command by pressing the F14 function key or by simply pressing the XMIT key. 


NOTE: 


Be sure that you select only one of the preceding actions from the command menu 
screen. If you enter both an EDT command and a request for a specific command help 
screen, EDT will not process the command you enter on the EDT COMMAND line. 


EDT command help screens show the syntax for the command and, if possible, a 
command entry line where you can enter any EDT command. The help screens give 
short, concise descriptions of the commands. For more detailed information about a 


command, see the appropriate command description in this manual. 
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The EDT help screen command formats differ slightly from the formats we present in 
this manual. These differences exist because the workstation screen (or one of the 
display devices that supports EDT) can’t display all of the characters in the formats we 
present in this manual. Although the syntax appears to be different, you should specify 
the EDT commands according to the statement of conventions we present in Section 1. 
Specifically, the conventions in this manual differ from those in the help screens in the 
ways the following table describes: 


CONVENTIONS USED IN THIS MANUAL CONVENTIONS USED IN COMMAND HELP SCREENS 


Underscoring (—_) indicates required Brackets (| |} around non-required letters 
letters in the abbreviations for in commands and parameters indicate the 
commands and parameters. @MOVE letters are optional. @M[OVE] 


Apostrophes (‘) enclose search-strings, Less-than and greater-than signs enclose 
change-strings, sequence-strings, and all strings. <SEARCH-STRING> 
strings. 


Shaded values NOQ_ indicate default No default values are shown. 
values. : 


Brackets large enough to surround a Brackets that surround only the line 
parameter indicate the parameter is on which the parameter name lies indicate 
optional. [,DEVICE= did the parameter is optional. DID 
DISK [,DEVICE= DISK ] 
DISKETTE DISKETTE 


All command formats include the / No command help screens include the optional 
optional string multiplication string multiplication factor. 
factor (*n). 


Choices are shown by braces ({}) Choices may be shown in one of several ways: 
enclosing a number of entries from 
which you must make a choice of one. u More than one format indicates you 

must choose one of the formats; 


DISK 
DISKETTE 


command 


[ors | data Slashes (/) between entries indicate 


you must choose one of the entries 
shown on either side of the slashes. 
<DATA>/<COMMAND> 


Less-than and equal-than signs 
indicate you must choose one of 
several values. DID 
< DISK > 
DISKETTE 


Uppercase letters indicate the command, All entries are uppercase, whether 
modifier, or parameter must be keyed in constant or variable. 

exactly as shown; lowercase letters 

indicate user-defined variables. @FIND ‘SEARCH-STRING' 


(FIND ‘search-string' 
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From the command help screens, you can do one of the following: 


Enter the EDT command explained in the screen by entering your command trigger 
and the command on the EDT command entry line and pressing the XMIT key 


Enter an EDT command different from the one explained in the screen by the same 
method just described 


Request that EDT display additional help for this command (such as additional 
syntax or definitions of the terms in the format) by pressing the F13 function key. 
From an additional prompt help screen, you can: 


— request to see a previously shown additional help screen by pressing FK12; 
— request to see a subsequent additional help screen by pressing F13 again; 


— enter an EDT command on the EDT command entry line and press the XMIT 
key; or 


— press F14 to return to the point where you originally requested help for the 
command. 


Each command help screen to which EDT can supply additional help displays your 
choice of actions at the bottom of the screen. If the choice FK13—ADDITIONAL 
PROMPT does not appear on the screen, EDT can supply no more additional help 
for the command. At that point, you can still perform any of the choices the screen 
does display. You perform the action exactly as we've just described. 


Return to your EDT session at the point where you originally entered the PROMPT 
command by pressing the F14 function key 
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The following example illustrates a typical use of the PROMPT command: 


You want to review the EDT commands, so you issue an @PROMPT command with no 
specific command after it. EDT displays the command menu screen and you decide you 
want to get help for the NUMBER command. You, therefore, key in NUMBER after the 
message, HELP FOR WHICH EDT COMMAND: (see the command menu screen shown 
previously). EDT then displays the help screen for the NUMBER command, which looks 
something like this: 


OS/3 EDT (V7.52) EDT COMMAND HELP 


KRACK KEKEKKEKEKREKUKRKKEKEKRKEEKERERUEEREKEMCEKEKREEKEEKEEKEERKEREUEKEEKEEEEEKEKEEEEKKE 
NUMBER Command Prompt 
The NUMBER command causes sequence numbering to be inserted in subsequent 
lines typed at the workstation. The COLUMN command modifier can be used 
with the NUMBER command to specify what column the sequence numbering 


should begin in. The number command remains in effect until an EDT 
command is entered. 


Syntax: @NU[ MBER] <sequence-string> [BEY] <increment>} 


FK13 - Additional Prompt FK14 - Return Transmit - Command 


EDT COMMAND : (Gu TUL) 3 San O074') Bae: D ae 


HMHEKKEKKEKEKKKEKEKERKEEEREEUCKEKKREREKEKEEKEEKEKKEEKKEKEEKCEEKEKKKKKKKKEKKKKKKKKKKKKK 


ERROR MESSAGE AREA (2 Lines) 





After reading this screen, you want to issue the NUMBER command. So you key in the 
NUMBER command as shown in the format and press the XMIT key. (Your keyin ts 
shown as white lettering on a black background on the sample screen.) EDT then 
processes the NUMBER command and returns you to the point in your EDT session at 
which you originally entered the PROMPT command. 
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8.6. RETURNING TO YOUR EDT SESSION FROM A SCREEN COMMAND 
(@RESTORE) 


The RESTORE screen command returns you to the point where you originally entered a 
screen command. The format of the RESTORE command is: 


@RESTORE 


The help screen format is: 


SYNTAX: @RES[TORE] 





The function key equivalent of the RESTORE command is F14. Pressing F14 is the same 
as keying in the @RESTORE command. 


The following example illustrates a typical use of the RESTORE command: 


Let's say you want to display the contents of the EDT work space on your workstation 
screen but you can't remember whether you need the LIST command or the PRINT 
command. You, therefore, issue an @PROMPT command to see ail the EDT commands. 
After reading the list of EDT commands, you request the help screen for the LIST 
command. The help screen tells you that the LIST command prints the work-space 
contents on your printer, so you conclude that you need the PRINT command. At this 
point, you issue an @RESTORE command to return to the point in your EDT session 
where you first issued the PROMPT command. Then you enter an @PRINT command 
and EDT displays the contents of its work space on your workstation screen. 
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8.7. VIEWING AND UPDATING LINES (@ROLL) 


The ROLL screen command lets you roll through EDT’s work-space file displaying lines 
and, if you want, updating or correcting them. The format of the ROLL command is: 


@ROLL 


The help screen format is: 


SYNTAX: @RO[LL] 





The function key equivalent of the ROLL command is F5. Pressing F5 is the same as 
keying in the @ROLL command. 


When you enter an @ROLL command, EDT displays its work-space contents on 
freeform screens that contain the number of lines you specified for the ROLL parameter 
on the @SET directive. The number of characters across one freeform screen depends 
on your specification for the SCRDSPLY parameter of the @SET directive. 
EDT displays the lines starting with the current line number. When it reaches the end of 
the work-space file, it starts displaying lines, beginning with line 1 of the work-space 
file. The roll function continues until you tell EDT to terminate it. 
When EDT displays each freeform screen, you have three options: 
= Update the currently displayed lines. 

You do this by: 

~ moving the cursor to the items you want to change, insert, or delete: 

- making those updates using keyboard keys (not EDT commands); 

~ moving the cursor to the bottom rightmost position on the screen: and 


- pressing the XMIT key to transmit the updated lines to the EDT work space. 


EDT then displays the next set of lines. 
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= Roll to the next freeform screen without changing the currently displayed lines by 
pressing the F19 function key. 


= =€=«Terminate the roll function by pressing the F14 function key. 


This option returns you to the point in your EDT session where you originally 
entered the ROLL command. 


The following is a sample freeform screen that EDT shows in response to a ROLL 


commana: 


OS/3 EDT (V7.52) EDT ROLL (15) TRUNCATE 


KEKEKKKKKKEEKEEREEEEKRERKEEREKKKEEKKEKEEKEKEEEREEEKEREEEKEKKEKEEEKKKEKKEEKKKKEKKEEKEK 


satwin Wis aie-n tale eo ae eek eed ten wera ie ei oc te ae So w Ste aaa Ola eg GA we were 


1 
2 
3 
4 
5 
6 
7 
8 


‘Oo 


10. 
11 
12. 
13 
14 
13’: 


-O@OOO>DATA 
-9OOOODATA 
.O@@OO>DATA 
. 9O@OOPDATA 
-OOO0PDATA 
-GO0GO>DATA 
-OOGOPDATA 
-OOOOPDATA 
-O@@OOPDATA 


QOOOr>DATA 


-9OOO>DATA 


OOOOrDATA 
OOOOr>DATA 


-O@OOO>DATA 


QOOOrDATA 


RECORD FOR CURRENT LINE NUMBER 
LINE 2 

LINE 

LINE 

LINE 

LINE 

LINE 

LINE 

LINE 9 

LINE 10 

LINE 11 

LINE 12 

LINE 13 

LINE 14 

LINE 15 LAST LINE 


FK19 - Continue Roll, No Update FK14 - Return Transmit - Update Lines 
KEKE KEK EEEKEKEKKKKEKCE KEKE KEKE KEKKREKEKEEKKE EKER UKEEKKREKEKEREREEEKEEKKKEREIUK 


ERROR MESSAGE AREA (2 Lines) 





Because of the way this user has specified the SCRDSPLY and ROLL parameters of the 
@SET directive, EDT dispiays 15 truncated lines at a time. 
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9. Function Keys 


The following function keys may provide some general assistance while using EDT: 


Function key 1 (F1) 


Shuts off the display of lines to the workstation while the current command 
continues to process. F1 is the same as F18. 


Function key 2 (F2) 
Terminates the current command. 
Function key 3 (F3) 


Displays a screen showing the parameters of the @SET directive, or those that 
make up your EDT environment. F3 is the same as issuing the PARAMS screen 
command (see Section 8). 


Function key 4 (F4) 


Displays a freeform screen through which you can switch to block mode for 
entering multiple commands or data. F4 is the same as issuing the BLOCK screen 
command (see Section 8). 


Function key 5 (F5) 


Displays freeform screens, showing the EDT work-space file, where you can update 
lines or simply view them. F5 is the same as issuing the ROLL screen command 
(see Section 8). 


Function key 6 (F6) 


Displays help screens for any EDT error messages. F6 is the same as issuing the 
HELP screen command (see Section 8). 


UP-8828 Rev. 2 SPERRY UNIVAC OS/3 9-2 
GENERAL EDITOR (EDT) 


m Function key 12 (F12) 


Lets you request a previously displayed additional help screen for a _ specific 
command when that command requires several help screens to fully describe it. 


m Function key 13 (F13) 


Displays the EDT command menu screen and help screens for any of the EDT 
commands (meaning EDT commands, modifiers, directives, procedure file 
commands, variables, and screen commands). F13 is the same as issuing the 
PROMPT screen command (see Section 8). From a help screen, F13 also lets you 
see subsequent help screens needed to fully explain the command. 


m= Function key 14 (F14) 


Returns you to the point in your EDT session where you originally entered a screen 
command. F14 is the same as issuing the RESTORE screen command (see Section 
8). 

m Function key 15 (F15) 


Recognized as EOF indicator. Halts an EDT session run in batch mode or produces 
an error message in interactive mode. 


m@ Function key 18 (F18) 


Shuts off the display of lines to the workstation while the current command 
continues to process. F18 is the same as F1. 


@ Function key 19 (F19) 


This is a system key that may be used to continue the output of data to the 
workstation once the workstation screen becomes full. 


The function keys 7-11, 16, 17, and 20-22 are invalid while using EDT. If pressed, 
EDT terminates the current command and displays an error message. The cursor returns 
to the next available work-space line for your next entry. 


When using EDT screens displayed by screen commands, the only function keys 
available to you are those displayed on the bottom of the screens. 


When using screen-mode screens, all the valid function keys described in this section 
are available to you. 


For more information on how to use these and other system function keys, see the 
interactive services commands and facilities user guide/programmer reference. 





UP-8828 Rev. 2 SPERRY UNIVAC 03/3 10-1 
GENERAL EDITOR (EDT) 


10. Screen Mode Processing 


10.1. INTRODUCTION 


Screen mode processing is an EDT facility that lets you enter source code or data, as 
easily as possible, from your workstation. In addition, you can use any of the EDT 
commands. Primarily, there are two major ways that EDT screen mode allows easier 
source or data entry. 


First, it allows you to enter up to 14 lines in one transmission. Depending on whether 
you want to enter single or multiple lines in one transmission, either: (1) EDT displays 
the contents of its work space as you transmit lines and scrolls the single lines up as it 
fills the screen; or (2) you enter up to 14 lines at a time before you transmit them. 


Second, screen mode provides formatted screens for entering source code or data. EDT 
supplies COBOL, RPG Il, or FORTRAN IV. screens. These screens identify the 
programming fields for whatever language you want to use. 


Also, screen mode provides a freeform screen where you can enter ASSEMBLER source 
code or uniform data. Although the OS/3 component, screen format services, lets you 
build screens to input data within a program, EDT’s screen mode lets you use screens 
to create data files independent of any program. Therefore, a practical application of 
screen mode would be for your data entry personnel to use the freeform screens to 
create or update name and address files, customer name and account number files, etc. 
You could then use any of these data files within any program you write. 


lf you are a COBOL or RPG II programmer, you may have used, or considered using, the 
EDT subeditors (the COBOL editor or the RPG Il editor). In addition to providing 
formatted screens, these subeditors also perform syntax checking on your source code. 
For creating a COBOL or RPG Il source module, then, you may prefer to use the 
language’s subeditor. However, for updating, if the updates to your source code aren't 
extensive and you feel you don’t need the syntax checking, you can use screen mode 


to make updates and changes very quickly. By using screen mode, you don't have to 
call up the subeditors for simple updates. 
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At this point, you should take note that processing in screen mode is not the same as 
using the EDT screen commands. The EDT screen commands operate in both line and 
screen mode and provide the same functions in both. Whatever mode you're in when 
you issue a screen command is the mode EDT returns you to after it processes the 
screen command you entered. 


Also, when working in screen mode, you have all of EDT’s capabilities. In fact, all the 
screens EDT displays in screen mode include an EDT command entry line. From this line 
(one on each screen), you can enter any of the EDT commands, except the UPDATE 
command. Screen mode uses the ROLL screen command for updating instead of the 
UPDATE command. 


To use screen mode, you first activate EDT as we describe in Section 2. Then, to tell 
EDT you want to operate in screen mode, you use the MODE parameter of the @SET 
directive. Before you transmit the @SET directive, however, you can also use several 
other parameters to tell EDT how you want to enter your source code or data. 


By choosing different values for these parameters of the @SET directive and combining 
them with the MODE parameter, you tell EDT what type of screen to display. This 
screen and the ones that follow it make entering your source code or data easier. 


See 10.2 for details about the values you can choose for these parameters and 
examples of the screens you'll see as a result of combining the different values for the 
parameters. See 10.3 for details on how you use screen mode to enter source code or 
data. Finally, 10.4 gives a sample screen mode session and Appendix G shows several 
screen mode sessions. 


You can use EDT screen mode in an interactive environment only. That is, you must be 
operating from your console/workstation in workstation mode or from a workstation. In 
addition, your workstation screen must be a 24 x 80 screen. 


10.2. DEFINING YOUR SCREENS 


As we mentioned in 10.1, you use a combination of parameter values for the @SET 
directive to tell EDT how you want to enter your source code or data in screen mode. 


Specifically, the @SET directive parameters that you use to define your screens are: 
SCRDSPLY, MODE, RECENTRY, LANGUAGE, and SCRFORM. Each of these parameters 
allows you to define a different characteristic of the type of screens you want to use 
while entering your source code or data. Once you transmit the @SET directive with 
specifications for these five parameters (or accept the default values for them), EDT 


immediately displays the first screen of the type you've defined and you're in screen 
mode. 


The following subsections (10.2.1 through 10.2.5) give your choices for each of these 
parameters and details about the values you can choose. Subsection 10.2.6 talks about 
the type of screens you'll see as a result of combining different values for the 
parameters and gives some examples. 
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No matter how you specify the parameters for the @SET directive, there are certain 
areas common to all the screens you'll see when operating in screen mode. 


The top of the screen always shows the EDT version number and your values for the 


LANGUAGE, RECENTRY, and SCRDSPLY parameters. It also shows the screen column 
numbers. 


The middle of the screen is where you enter your source code or data. It always 
includes an EDT command entry line for entering any EDT command (except the 
UPDATE command). 


The bottom of every screen is reserved for displaying error messages you may receive 
from EDT or your system while operating in screen mode. 

10.2.1. Defining the Character Length of Your Records (SCRDSPLY) 

The screen display parameter (SCRDSPLY) tells EDT whether you want to display and 
input full-length character records (those containing up to 128 characters) or partial 


character records (those containing 7O characters or less). 


The format of the SCRDSPLY parameter is: 


sem P| 





SCRDSPLY=TRUNCATE specifies that you want EDT to truncate all lines you enter (or 
that it displays) to 7Q characters or less. This specification allows you to enter or 
display more records per screen than SCRDSPLY=FOLD because SCRDSPLY= 


TRUNCATE causes EDT to accept or display one screen line per one source or data 
line. 


When SCRDSPLY=TRUNCATE and RECENTRY=SINGLE, your screen's display area 
shows a 70-column display no matter what you specify for the LANGUAGE parameter. 


SCRDSPLY =FOLD specifies that you don’t want EDT to truncate lines you enter (or that 
it displays) to 7O characters or less. When SCRDSPLY=FOLD, EDT displays and 
accepts up to 128 characters. This specification reduces the number of records per 
screen that EDT can display because SCRDSPLY=FOLD causes EDT to accept or 
display two lines for every single source or data line. 


When SCRDSPLY=FOLD and RECENTRY=SINGLE, your screens’ display area shows a 
128-column display no matter what you specify for the LANGUAGE parameter. 
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NOTE: 


Regardless of your specification for the SCRDSPLY parameter, EDT processes 
128-character records in screen mode. Also, EDT places the records in its work space 
with or without trailing spaces and X‘OO’s, depending on your specification for the 
STRIP parameter of the @SET directive. In other words, if your records are less than 
128 characters long, EDT pads them with spaces or strips them of trailing spaces and 
X‘O0's (depending on your specification for STRIP) before placing your records in the 
EDT work space. 


10.2.2. Defining Your EDT Mode of Operation (MODE) 


The mode of operation parameter (MODE) tells EDT that you want to enter screen 
mode. The format of the MODE parameter is: 





none (ER 
SCREEN 


MODE=LINE alows you to operate only in line mode. 


MODE=SCREEN allows you to operate only in screen mode. Of the five parameters that 
let you define your screens, this parameter is the only one you must specify 
(MODE=SCREEN) to enter screen mode. Therefore, it isn’t an optional parameter for 
screen mode processing. 


10.2.3. Defining the Number of Record Entries in One Transmission (RECENTRY) 


The record entry parameter (RECENTRY) defines the number of records or lines you 
may enter before you press the XMIT key. The format of the RECENTRY parameter is: 


perenne aad | 


RECENTRY=SINGLE specifies that you want to enter one record at a time, pressing the 
XMIT key after each one. If you specify RECENTRY=SINGLE, EDT displays a screen 
divided into four areas (see 10.2.6. for some examples): 





i The environment area, which is common to all screen-mode screens 


= The error message area, which is also common to all screen-mode screens 


= A source code or data entry line, where you can enter one line at a time, and an 
EDT command entry line, where you can enter one EDT command at a time 
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From this section of the screen, you can enter both source code or data and an 
EDT command. If entering both, EDT places the source code or data in its work 
space first, then processes the EDT command. If you enter neither, EDT places a 
biank line in its work space after you press the XMIT key. 


EDT precedes the entry line with its current work-space line number. Your 
specification for the LANGUAGE parameter determines the format of the source 
entry line. 


A display area that shows the source code or data you entered in the entry line. 
When you enter a line from the entry line, EDT displays it in the last line of the top 
(or display) portion of the screen before you enter the next line. When it fills the 
display area, EDT scrolls the lines up to make room for the rest of the lines you 
enter. EDT protects the display area; therefore, you can't enter any source code or 
data directly to it. 


EDT always displays your lines in set columns that are unrelated to the language 
format you used to enter your source code or data. When SCRDSPLY = TRUNCATE 
and RECENTRY=SINGLE, your screens’ display areas show a 70-column display no 
matter what you specify for the LANGUAGE parameter. When SCRDSPLY =FOLD 
and RECENTRY=SINGLE, your screens’ display areas show a 128-column display 
area, no matter what you specify for LANGUAGE. 


RECENTRY=MULT specifies that you want to enter from 1 to 14 records or lines in 
One transmission. If you specify RECENTRY=MULT, EDT displays a screen divided into 
three areas (see 10.2.6 for some examples): 


The environment area, which is common to all screen-mode screens 
The error message area, which is also common to all screen-mode screens 


The source code or data entry area, which includes 14 lines where you can enter 
source code or data, and one EDT command entry line, where you can enter one 
EDT command at a time 


From this section of the screen, you can enter both source code or data and an 
EDT command. If entering both, EDT places the source code or data in its work 
space first, then processes the EDT command. 


EDT precedes the first entry line with its current work-space line number. The 
format of the entry lines is determined by your specification for the LANGUAGE 
parameter. 


EDT places embedded blank lines in its work space as blank lines; EDT doesn't 
place trailing blank lines in its work space. 
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10.2.4. Defining the Language Format of Your Screens (LANGUAGE) 


The language parameter (LANGUAGE) tells EDT which type of formatted screen to 
display for entering source code or data. The format of the LANGUAGE parameter is: 





LANGUAGE=/ #REERORM 


ge 
ates 

myaatatater etna renee 

asec S 


FORTRA 
COBOL 
RPG 


LANGUAGE=FREEFORM displays a freeform screen that you can design to accept 
uniform data or assembler source code. This screen has no fields or tabs set up. It 
accepts up to 128-character records and truncates them or folds them, depending on 
your specification for the SCRDSPLY parameter. 


LANGUAGE=FORTRAN displays formatted screens designed to help you enter 
FORTRAN IV source code. The maximum record size for FORTRAN IV source entry 
records on this screen is 80 characters. EDT performs no syntax checking for FORTRAN 
IV source code entered on this screen. 


If your specification for RECENTRY is SINGLE, then the FORTRAN IV formatted screen 
contains preset fields for the LABEL (columns 1 to 5), CONTINUATION (column 6), 
STATEMENT (columns 7 to 72), and IDENTIFICATION (columns 73 to 80) sections of 
your program. 


If your specification for RECENTRY is MULT, then the FORTRAN IV formatted screen 
has preset tabs at column 1 for the start of the LABEL field, column 6 for the 
CONTINUATION field, column 7 for the start of the STATEMENT field, and column 73 
for the start of the IDENTIFICATION field. 


LANGUAGE=COBOL displays formatted screens designed to help you enter COBOL 
source code. The maximum record size for COBOL source entry records on this screen 
is 80 characters. EDT performs no syntax checking for COBOL source code entered on 
this screen. 


If your specification for RECENTRY is SINGLE, the COBOL formatted screen contains 
preset fields for the SEQUENCE (columns 1 to 6), CONTINUATION (column 7), TEXT A 
(columns 8 to 11), TEXT B (columns 12 to 72), and IDENTIFICATION (columns 73 to 
80) sections of your program. These fields take up two lines on the screen, but EDT 
processes them in the proper columns. 


If your specification for RECENTRY is MULT, the COBOL formatted screen has preset 
tabs at column 1 for the start of the SEQUENCE field, column 7 for the CONTINUATION 
field, column 8 for the start of the TEXT A field, column 12 for the start of the TEXT B 
field, and column 73 for the start of the IDENTIFICATION field. 
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Note that the COBOL screens identify the IDENTIFICATION field for your program, not 
the IDENTIFICATION DIVISION of your program. 


LANGUAGE=RPG displays formatted screens designed to help your enter RPG Il source 
code. The maximum record size for RPG Il source entry records on this screen is 80 
characters. EDT performs no syntax checking for RPG Il source code entered on this 
screen. 


If your specification for RECENTRY is SINGLE, then the RPG II formatted screen contains 
preset fields for the PAGE-LINE (columns 1 to 5), FORM (column 6), CONTROL-FIELDS 
(columns 7 to 74), and PROGRAM-ID (columns 75 to 80) sections of your program. 
These fields take up two lines on the screen, but EDT processes them in their proper 
columns. 


lf your specification for RECENTRY is MULT, the RPG Il formatted screen has preset 
tabs at column 1 for the start of the PAGE-LINE field, column 6 for the FORM field, 
column 7 for the start of the CONTROL-FIELDS, and column 75 for the start of the 
PROGRAM-ID field. 


Each formatted screen contains an EDT command entry line where you can enter any 
EDT command along with your source code or data. If you enter both, EDT places the 
source code or data in its work space first, then processes the command. 


see 10.2.6 for examples of the formatted screens EDT displays in screen mode. 


10.2.5. Defining Your Character Input Prompt (SCRFORM) 


The screen format parameter (SCRFORM) tells EDT which format to use as a character 
input prompt on the screens it displays - either underlines or blanks. The format of the 
SCRFORM parameter is: 


a RRR RR RRC S 
o Bo . Og 
BS B bi SRS 3S i 
Ss iron 
sgzehceaneen ete eees eee 
— 


SCRFORM=UNDERLINE tells EDT that you want your entry screens to have underlines 
as character input prompts. When you transmit these screens, EDT changes your 
unused underline characters to blanks; therefore, you don't have to be concerned with 
them. Remember, if you specify SCRFORM=UNDERLINE, you can‘t use an underline 
character in any of your source code or data. Instead, you must substitute a different 
character and later change it to an underline using the EDT CHANGE command. 





SCRFORM=BLANK tells EDT that you want your entry screens to have no character 
input prompts at all. Since you won't be able to see where field settings start, you can 
simply tab to the next field. When SCRFORM=BLANK, you can enter any character on 
your EDT commands. 
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No matter what you specify for SCRFORM, the EDT command entry line on all the 
screen mode screens contains no character input prompt. We designed screen mode in 
this way so you can enter the underline as a valid character in any EDT command at 
any time. 


10.2.6. Sample Screen Mode Screens 


As you can see from reading the previous five sections, EDT can display a variety of 
screens to help you enter your source code or data in screen mode. The screens it 
displays, then, depend on your specifications for the parameters described in 10.2.1 
through 10.2.5. 


This subsection talks about the types of screens you'll see and use as a result of 
combining the different values on the parameters and gives some examples. For a 
discussion of how you actually use screen-mode screens for entering source code or 
data, see 10.3. 


Remember that there are certain areas common to all screen-mode screens. We 
describe these common areas at the beginning of 10.2. 


10.2.6.1. Sample Screens for Entering Data or Assembler Source Code 
(LANGUAGE=FREEFORM) 


Here, we'll show two typical examples of screens EDT may display to help you enter 
data or ASSEMBLER source code. Whether EDT displays these types of screens 
depends on your specifications or default values for the SCRDSPLY, RECENTRY, and 
SCRFORM parameters of the @SET directive. Because you'll probably want to enter 
more than one data or ASSEMBLER source line at a time, we give examples where the 
value for RECENTRY equals MULT, or where the screens accept 1 to 14 lines in one 
transmission. 


Example 1: 
Let’s say you specify: 


QSET MODE=SCREEN 
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As soon as you press the XMIT key, EDT displays a screen similar to this one: 


0S/3 EDT (V7.52) EDT FREEFORM MULT TRUNCATE 


HEKREKKEREEREKEEKKEKEKEKEEKEKEKEKEEKEEEKEKEKEEEKEKEEEEEEEKKEREESEREEEEKREKEEKEKKURUEREREKE 


- 9900 
- 9600 
- 0009 
- 9000 
- 900 
- 0000 
- 9900 
- 9900 
- 0000 
- 9999 
- 0900 
9900 
- 9960 
- 9900 


1 
2 
3 
4 
5 
6 
7 
8 


EDT COMMAND: 
HH He HHI HITE H RENE III RIT R IRI IAAI ARIA TAIT IIR KI AIA TARA RAKE IKEA REE EERE 


ERROR MESSAGE AREA (2 Lines) 





Because you didn't specify the SCRDSPLY, RECENTRY, LANGUAGE, or SCRFORM 
parameters, EDT uses the default values for those parameters. Therefore, it displays a 
freeform screen that accepts up to 14 partial lines of data or ASSEMBLER source code 
and includes underlines as data prompts. 
Example 2: 
Let's say you specify: 

aSET SCRDSPLY=FOLD,MODE=SCREEN, SCRFORM=BLANK 
As soon as you press the XMIT key, EDT displays a screen similar to this one: 


OS/3 EDT (V7.52) EDT FREEFORM MULT FOLD 


KEKE KKREKKKEKKEKEHEKREEKEKEKEREKEEKEREKKEEEREREKREKEERREEEKREKKKEKKKEKKKKEKEKKEEEKKKKKKKEKKKEKK 


EDT COMMAND: 
HHMI HITHER IRIE RIAU REE EREERMNEEERKEKEK KKK KKKKREK 


ERROR MESSAGE AREA (2 Lines) 
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Because you didn’t specify the RECENTRY or LANGUAGE parameters, EDT uses the 
default values for those parameters. Therefore, it displays a freeform screen that 
accepts up to 7 full-character lines of data or ASSEMBLER source code and includes no 
data prompts. 


10.2.6.2. Sample Screens for Entering FORTRAN IV Source Code 
(LANGUAGE=FORTRAN) 

Here, we'll show two typical examples of screens EDT may display to help you enter 

FORTRAN IV source code. Whether EDT displays these types of screens depends on 

your specifications or default values for the SCRDSPLY, RECENTRY, and SCRFORM 

parameters of the @SET directive. Because you'll probably want to enter more than one 

FORTRAN IV source line at a time, we give examples where the value for RECENTRY 

equals MULT, or where the screens accept 1 to 14 lines in one transmission. 

Example 1: 

Let's say you specify: 


QSET SCRDSPLY=FOLD ,MODE=SCREEN, LANGUAGE=FORTRAN 


As soon as you press the XMIT key, EDT displays a screen similar to this one: 


OS/3 EDT (V7.52) EDT FORTRAN MULT FOLD 


KKK KKH KKK IKI KK EEK KEK KKK KEKE KEKE EKEREKEEKEEEKEKKEKEKKEKKKEKEEKKKKKEKKEKE 


EDT COMMANDS: 


KHER HK KEK KEK KKK KEKE KEKE ECE EKER EKEKEEKEEKEREKCEKEEEKEEKKEKEEKKEKKKKKKKKKKK 


ERROR MESSAGE AREA (2 Lines) 





Because you didn't specify the RECENTRY or SCRFORM parameters, EDT uses the 
default values for those parameters. Therefore, it displays a screen that accepts up to 7 
full-character lines of FORTRAN IV source code and includes underlines as data 
prompts. 
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Example 2: 
Let's say you specify: 
@SET MODE=SCREEN, LANGUAGE=FORTRAN, SCRFORM=BLANK 


As soon as you press the XMIT key, EDT displays a screen similar to this one: 


0S$/3 EDT (V7.52) EDT FORTRAN MULT TRUNCATE 


HHH KK KK KKK KI KEK HK KKH EEKEEKR KEKE KEMEKREEEEKEKEEK 


LABEL C STATEMENT 
- 9000 
. 0900 
- 9000 
- 9900 
9900 
. 9000 
0000 
0000 
. 9900 
- 9900 
. 9900 
. 9000 
. 0000 
- 60900 
EDT COMMAND: 
FOI TR  TRIOR FIO K IORI I III TOI TTT TOT ITOK ITT IO IT TIT TI ITI TTI II I TIA TIAA IIA TIARA 


ERROR MESSAGE AREA (2 Lines) 


‘ 
2 
3 
4 
5 
6 
re 
8. 





Because you didn't specify the SCRDSPLY or RECENTRY parameters, EDT uses the 


default values for those parameters. Therefore, it displays a screen that accepts up to 
14 partial lines of FORTRAN IV source code and includes no data prompts. 


10.2.6.3. Sample Screens for Entering COBOL Source Code (LANGUAGE=COBOL) 


Here we'll show two typical examples of screens EDT can display to help you enter 
COBOL source code. Whether EDT displays these types of screens depends on your 
specifications or default values for the SCRDSPLY, RECENTRY, and SCRFORM 
parameters of the @SET directive. Because you'll probably use screen mode for only 
updating or correcting (not creating) COBOL source modules, we give examples where 
the value for RECENTRY equals SINGLE, or where the screens accept only one source 
line at a time. 


Example 1: 
Let's say you specify: 


@SET MODE=SCREEN, RECENTRY=SINGLE, LANGUAGE=COBOL 
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As soon as you press the XMIT key, EDT displays a screen similar to this one: 


OS/3 EDT (v7.52) EDT COBOL SINGLE TRUNCATE 


KEKE KEKE KHER EREKRHK EEE EKER EKREEUMERKEEKKEKKEKEEEKKEKEEKKEKEEK 


LINE # SEQUENCE CONTINUATION TXTA 


EDT COMMAND: 


REECE KKK KEE KERR KEKE KEEEKKEKEEKKKKEREHKKEKKKEEEKKKKKKKKKEKEK 


ERROR MESSAGE AREA (2 tines) 





Because you didn't specify the SCRDSPLY or SCRFORM parameters, EDT uses the 
default values for those parameters. Therefore, it displays a screen that accepts one line 
of COBOL source code at a time and includes underlines as data prompts. Notice that 
this screen's display area has room for only a 7Q-column display and its source entry 
area accepts 80 characters. 


Example 2: 
Let's say you specify: 


@SET SCROSPLY=FOLD, MODE=SCREEN, RECENTRY=SINGLE, LANGUAGE=COBOL , SCRFORM=BLANK 


As soon as you press the XMIT key, EDT displays a screen similar to this one: 


OS/3 EDT (V7.52) EDT COBOL SINGLE FOLD 


KREME KERR KEKE REE MEKKEKRE KEKE KERRIER EKEEEKKEKEEEMEKAKKEEEES 


ee ee ee ee en eee ere a, EL Ie. NEO, SMM EET | RRO EOE 3 


LINE # SEQUENCE CONTINUATION TXTA 
1.0006 
TXTB IDENTIFICATION 


EDT COMMAND: 


HEKCKEKKAHKEKAHKEERKEEREEAKEERERERKEEKEEEEKEEKKEKEEKKEEKEUKREEEEKEERERERERKREREKKKKKE HES 


ERROR MESSAGE AREA (2 Lines) 
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Because you didn't accept the default values for any of the five parameters that 
determine your screens, EDT uses your specifications for all the parameters. Therefore, 
it displays a screen that accepts one full-character line of COBOL source code at a time 
and includes no data prompts. Notice that this screen's display area has room for a 
128-column display, regardless of the fact that COBOL screens accept only 80-character 
records. 


10.2.6.4. Sample Screens for Entering RPG II Source Code (LANGUAGE= RPG) 
Here we ll show two typical examples of screens EDT displays to help you enter RPG Il 
source code. Whether EDIT displays these types of screens depends on your 
specifications or default values for the SCRDSPLY, RECENTRY, and SCRFORM 
parameters of the @SET directive. Because you'll probably use screen mode for only 
updating or correcting (not creating) RPG Il source modules, we give examples where 
the value for RECENTRY equals SINGLE (the screens accept only one source line at a 
time). 

Example 1: 

Let's say you specify: 


QSET SCRDSPLY=FOLD, MODE=SCREEN, RECENTRY=SINGLE, LANGUAGE=RPG 


As soon as you press the XMIT key, EDT displays a screen similar to this one: 


OS/3 EDT (V7.52) EDT RPG SINGLE FOLD 


KEKE KKEKKKEKHEKEKEEKEKEEEKKKEEKRKEKEKCKEKEKKEKEKEEKEEEKKKEKREEKKKEKKKKKKKKKKKKKKKKKRKKKEE 


er Se ee, ny rn ee: Pe ere nat Sen: (OA, ee , Aan eeeneeree 2 


PG-LN FORM CONTROL -FIELDS/PROGRAM- ID 


EDT COMMAND: 


KKH KKK KEHEKHEK KEKE EEE KKEUKEKEEEEKEEKK KKK RAKE EEEKEKRKEKERKKEKEMERKEKERKEKKKKKKK 


ERROR MESSAGE AREA (2 Lines) 
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Because you didn't specify the SCRFORM parameter, EDT uses the default value for that © 
parameter. Therefore, it displays a screen that accepts one full-character line of RPG Il 

source code at a time and includes underlines as data prompts. Notice that this screen’s 

display area has room for 128-character display, regardless of the fact that RPG Il 

screens accept only 80-character records. 


Example 2: 
Let’s say you specify: 


@SET MODE=SCREEN, RECENTRY=SINGLE, LANGUAGE=RPG , SCRFORM=BLANK 


As soon as you press the XMIT key, EDT displays a screen similar to this one: 


OS/3 EDT (V7.52) EDT RPG SINGLE TRUNCATE 


KKK IKK KIKI KKK KKK KKK KKK IKKE EERE KEKE KEK EEK EERE KEE KKEKEEEKKHEKEKEKEKKKKEK 


PG-LN FORM CONTROL-FIELDS/PROGRAM- ID & 


EDT COMMAND: 


HHH IKK KKK KKK KEKE KEE EEE KEKE KEEKEEHKEEKEREEKEKERERKEEREEEEREEEEEKKEKKEKKKKKKK 


ERROR MESSAGE AREA (2 lines) 





Because you didn’t specify the SCRDSPLY parameter, EDT uses the default value for 
that parameter. Therefore, it displays a screen that accepts one line of RPG Il source 
code at a time and includes no data prompts. Notice that this screen's display area has 
room for only a 70-column display. 


10.3. USING SCREEN MODE 


10.3.1. Beginning Your Screen Mode Session 


To begin your screen mode session, key in: 


@SET MODE=SCREEN [ parameters] 
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where: 
parameters 

Are any of the four parameters that define the type of screens EDT displays in 
screen mode. We describe these parameters in detail in 10.2 and give 
recommendations for specifying them, depending on what you're entering, in 
10.3.2.1 through 10.3.2.4. 

Once you press the XMIT key after entering the MODE parameter of the @SET 

directive, EDT immediately displays a screen of the type you've defined and you're in 

screen mode. From this point on, you can do any of the following: 

m™ enter source code or data (see 10.3.2); 

= enter EDT commands (10.3.3); 

m™ display EDT’s work-space contents (10.3.4); or 


= end your screen mode session (10.3.5). 


10.3.2. Entering Source Code or Data 


As soon as you enter the @SET MODE=SCREEN directive, EDT displays a screen-mode 
screen of the type you've defined. 


From this screen, you enter source code or data. Each time you press the XMIT key, 
EDT displays another screen of the same type. EDT keeps displaying the same type of 
screen until you do one of the following: 


m redefine your type of screens; 
= #=end your screen mode session; or 


= terminate EDT. 


Naturally, the way you use the screen mode screens differs, depending on whether 
youre entering source code or data and on how you defined your screens. And if 
you re entering source code, the method depends on whether you're entering FORTRAN 
IV, COBOL, or RPG Il source code. The following subsections, therefore, discuss 
entering data and each type of source code using screen-mode screens. 
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However, there are certain considerations you should be aware of no matter what 
you re entering in screen mode. They are: 


When EDT displays a new screen-mode screen, the cursor is always positioned at 
the next available work-space line number. You can change this line number using 
the EDT @ command, but EDT interprets the line number at the time of 
transmission as the current line number. 


You can't enter source code or data from the EDT command entry line on any 
screen-mode screens, nor can you use the double at sign (@@) before a data line 
to enter data from the EDT command entry line. EDT flags as invalid anything 
entered from this line except an EDT command. 


Before pressing the XMIT key on any screen, be sure that you move the cursor to 
the bottom rightmost position on the screen to ensure that EDT transmits all your 
source code or data to its work-space file. 


From any screen you can enter both source code or data and an EDT command. If 
entering both, EDT places the source code or data in its work space first, then 
processes the EDT command. If you enter neither, and your screens accept single 
record entries, EDT places a blank line in its work space after you press the XMIT 
key. 


lf your screens contain underlines as entry prompts, don’t include underlines in your 
source code or data entries. Instead, use another character. Then, go back and 
change that character to an underline using the EDT CHANGE command. If you 
accidentally include an underline, EDT processes it as though it were a_ blank 
character. 


lf your screens don't contain underlines as entry prompts, tab to the various 
programming fields on the screens since you can’t see where the fields begin and 
end. 


Regardless of whether your screens use underlines as entry prompts, the EDT 
command entry line never includes underlines. We designed screen mode in this 
way so you can enter the underline character in any EDT command at any time. 


lf your screens accept single-record truncated entries, their display areas show the 
last 10 lines of source code or data you entered. If they accept single full-character 
records, your screens’ display areas show the last five lines of source code or 
data, because full-character records take up twice aS many lines as truncated 
records. 
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m If your screens accept multiple records, EDT places embedded blank lines in its 
work space as blank lines; however, it doesn't place trailing blank lines in its work 
space. For example, if on one screen you enter four lines of data, skip line 5, enter 
two more lines of data, and press the XMIT key, EDT places lines 1 through 7 in 
its work space. The next screen EDT displays will show the current line number as 
8.0000. 


= If you're using screen mode to update a module or file, you must enter a READ 
command to copy the module or file you want to update from its permanent file to 
the EDT work space. Next, enter a PRINT command to display the module or file 
on your workstation screen and note the lines that need to be updated. You can 
enter these commands before or after you issue the SET directive to enter screen 
mode. 


m If you enter more characters than a screen mode field accepts, EDT automatically 
tabs to the next field. In these cases, use the TAB BACK key to go back to the 
field and enter the correct number of characters. 


10.3.2.1. Entering Data or Assembler Source Code 


To enter data or Assembler source code, you should have begun your screen mode 
session (10.3.1) with the value for the LANGUAGE parameter of the @SET directive 
equal to FREEFORM (LANGUAGE=FREEFORM). Because FREEFORM is the default for 
that parameter, you didn't have to specify it explicitly when you began your screen 
mode session. . 


When keying in the @SET directive to begin your screen mode session, you should also 
specify the various parameters for the directive in the following way: 


= If your lines of input are longer than 7O characters across, specify SCRDSPLY as 
FOLD. 


= lf you're creating a data file or Assembler module, be sure the value for the 
RECENTRY parameter is MULT for multiple record entry. If you're merely updating 
an existing data file or Assembler module, you may want to specify RECENTRY as 
SINGLE to enter one line of data or assembler code in each transmission. 


a lf your lines of input contain underlines, specify SCRFORM as BLANK. 


= #8 If you want your data in columns, use the CHAR and TABS parameters to set your 
tab stops and identify your tab key. 


See 10.2 for a complete description of the SCRDSPLY, RECENTRY, and SCRFORM 
parameters and 7.9 for a complete description of the TABS and CHAR parameters. 


As soon as you transmit the @SET directive to begin your screen mode session, EDT 
displays a freeform screen whose characteristics depend on your specifications for the 
SCRDSPLY, RECENTRY, and SCRFORM parameters. The cursor is positioned at the first 
input field on your workstation screen. 
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When EDT displays this freeform screen, enter your lines of data or Assembler code. 
Although you can't enter column headings for your input, you can have EDT process 
them in column format. You do this by pressing your tab key (specified by the CHAR 
parameter) each time you want to enter an item at a preset tab stop (specified by the 
TABS parameter). 


When using the freeform screens, the EDT tab function operates as we describe in 7.9. 
That is, when you actually press your tab character while entering input, EDT doesn't 
move the cursor to the appropriate tab the way it does on the formatted screens for 
FORTRAN IV, COBOL, and RPG Il (or the way a typewriter does). However, in the 
future, whenever EDT displays your input on the workstation screen or prints a listing of 
it, the input will be in the correct tab format you designed. 


The way you enter your input lines depends on your value for the RECENTRY 
parameter: 


m If your value for RECENTRY is SINGLE, press the XMIT key after each line you 
enter. 


m If your value for RECENTRY is MULT, press the TAB FORWARD key after each line 
to position the cursor at the beginning of the next line. Then, when you've entered 
your entire screen (no more than 14 lines), press the XMIT key. 


Either method results in EDT displaying another screen of the same type. Keep following 
one of these methods until you've entered all the lines of data or Assembler code you 
have. When you're finished, you can perform any of the functions we describe in 
10.3.1. See 10.4 for a sample screen mode session for creating a data file and 
Appendix G for a sample session for updating a MIRAM data file in screen mode. 


10.3.2.2. Entering FORTRAN IV Source Code 


To enter FORTRAN IV source code, you should have begun your screen mode session 
(10.3.1) with the value for the LANGUAGE parameter of the @SET directive equal to 
FORTRAN (LANGUAGE=FORTRAN). When keying in the directive to begin your session, 
you should also specify the various parameters in the following way: 


= = If your FORTRAN IV source lines are longer than 70 characters, specify SCRDSPLY 
as FOLD. 


= If you're creating a FORTRAN IV source module, be sure the value for the 
RECENTRY parameter is MULT for multiple record entry. If you're merely updating 
an existing FORTRAN IV source module, you may want to specify RECENTRY as 
SINGLE to enter one line of FORTRAN IV source code in each transmission. 


= = !f your FORTRAN IV source code contains underlines, specify SCRFORM as BLANK. 


See 10.2 for a complete description of the SCRDSPLY, RECENTRY, and SCRFORM 
parameters. 


8 
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As soon as you transmit the @SET directive to begin your screen mode session, EDT 
displays a FORTRAN IV screen whose characteristics depend on your specifications for 
the SCRDSPLY, RECENTRY, and SCRFORM parameters. The cursor is positioned at the 
first input field on your workstation screen. 


When EDT displays your FORTRAN IV screen, you enter your source code in one of the 
following ways, depending on your value for the RECENTRY parameter: 


m if the value for RECENTRY is SINGLE, the FORTRAN IV screen contains preset and 
marked fields for the LABEL (columns’ 1-5), CONTINUATION (column. 6), 
STATEMENT (columns 7-72), and IDENTIFICATION (columns 73-80) sections of 
your program. Enter each line of your source code, pressing the TAB FORWARD 
key to move to the next field. At the end of each line, press the XMIT key. EDT 
then displays another FORTRAN IV screen of the same type. 


m # If the value for RECENTRY is MULT, the FORTRAN IV screen has preset tabs at 
column 1 for the start of the LABEL field, column 6 for the CONTINUATION field, 
column 7 for the start of the STATEMENT field, and column 73 for the start of the 
IDENTIFICATION field. The screen accepts up to 14 truncated lines of FORTRAN IV 
source code or 7 full-character lines. 


Enter each line of your source code, pressing the TAB FORWARD key to move the 
next field. At the end of each line, press the TAB FORWARD key to move to the 
next line. When you've entered your entire screen (up to 14 lines), press the XMIT 
key. EDT then displays another FORTRAN IV screen of the same type. 


Keep following one of these methods until you've entered all your FORTRAN IV code. 
When you're finished, you can perform any of the functions described in 10.3.1. 


10.3.2.3. Entering COBOL Source Code 


To enter COBOL source code, you should have begun your screen mode session 
(10.3.1) with the value for the LANGUAGE parameter of the @SET directive equal to 
COBOL (LANGUAGE=COBOL). When keying in the directive to begin your session, you 
should also specify the various parameters in the following way: 


m= If your COBOL source code lines are longer than 70 characters across, specify 
SCRDSPLY as FOLD. 


m Because you'll probably use screen mode for only updating or correcting (not 
creating) COBOL source modules, specify RECENTRY as SINGLE. Of course, if you 
want to use screen mode instead of the COBOL editor to create COBOL source 
modules, specify RECENTRY as MULT for multiple record entry. 


= If your COBOL source code contains underlines, specify SCRFORM as BLANK. 


See 10.2 for a complete description of the SCRDSPLY, RECENTRY and SCRFORM 
parameters. : 
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As soon as you transmit the @SET directive to begin your screen mode session, EDT 
displays a COBOL screen whose characteristics depend on your specifications for the 
SCRDSPLY, RECENTRY, and SCRFORM parameters. The cursor is positioned at the first 
input field on your workstation screen. 


When EDT displays your COBOL screen, you enter your source code in one of the 
following ways, depending on your value for the RECENTRY parameter: 


= If the value for RECENTRY is SINGLE, the COBOL screen contains preset and 
marked fields for the SEQUENCE (columns 1-6), CONTINUATION (column 7), TEXT 
A (columns 8-11), TEXT B (columns 12-72), and IDENTIFICATION (columns 
73-80) sections of your program. These fields take up two lines of your screen but 
EDT processes them in their proper columns. Enter each line of your source code, 
pressing the TAB FORWARD key to move to the next field. At the end of each 
line, press the XMIT key. EDT then displays another COBOL screen of the same 
type. Note that IDENTIFICATION refers to the identification of your program, not its 
IDENTIFICATION DIVISION. 


m 8 lf the value for RECENTRY is MULT, the COBOL screen has preset tabs at column 1 
for the start of the SEQUENCE field, column 7 for the CONTINUATION field, column 
8 for the start of the TEXT A field, column 12 for the start of the TEXT B field, 
and column 73 for the start of the IDENTIFICATION field. Note that 
IDENTIFICATION refers to the’ identification of your program, not its 
IDENTIFICATION DIVISION. The COBOL screen accepts up to 14 truncated lines of 
COBOL source code or 7 full-character lines. 


Enter each line of your code, pressing the TAB FORWARD key to move to the next 
field. At the end of each line, press the TAB FORWARD key to move to the next 
line. When you've entered your entire screen (up to 14 lines), press the XMIT key. 
EDT then displays another COBOL screen of the same type. 


Keep following one of these methods until you’ve entered all your COBOL code. When 
you're finished, you can perform any of the functions described in 10.3.1. See 
Appendix G for a sample screen mode session for updating a COBOL source module. 


10.3.2.4. Entering RPG Il Source Code 


To enter RPG Il source code, you should have begun your screen mode session (10.3.1) 
with the value for the LANGUAGE parameter of the @SET directive equal to RPG Il 
(LANGUAGE=FPG il). When keying in the directive to begin your session, you should 


also specify the various parameters in the following way: 


= If your RPG Il source code lines are longer than 70 characters across, specify 
SCRDSPLY as FOLD. 


m Because you'll probably use screen mode for only updating or correcting (not 
creating) RPG II source modules, specify RECENTRY as SINGLE. Of course, if you 
want to use screen mode instead of the RPG II editor to create an RPG Il source 
module, specify RECENTRY as MULT for multiple record entry. 
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= If your RPG Il source code contains underlines, specify SCRFORM as BLANK. 


see 10.2 for a complete description of the SCRDSPLY, RECENTRY, and SCRFORM 
parameters. 


As soon as you transmit the @SET directive to begin your screen mode session, EDT 
displays an RPG Il screen whose characteristics depend on your specifications for the 
SCRDSPLY, RECENTRY, and SCRFORM parameters. The cursor is positioned at the first 
input field on your workstation screen. 


When EDT displays your RPG Il screen, you enter your source code in one of the 
following ways, depending on your value for the RECENTRY parameter: 


ws If the value for RECENTRY is SINGLE, the RPG Il screen contains preset and marked 
fields for the PAGE-LINE (columns 1-5), FORM (column 6), CONTROL-FIELDS 
(columns 7-74), and PROGRAM-ID (columns 75-80) sections of your program. 
These fields take up two lines on your screen, but EDT processes them in their 
proper columns. Enter each line of your source code, pressing the TAB FORWARD 
key to move to the next field. At the end of each line, press the XMIT key. EDT 
then displays another RPG Il screen of the same type. 


m lf the value for RECENTRY is MULT, the RPG Il screen has preset tabs at column 1 
for the start of the PAGE-LINE field, column 6 for the FORM field, column 7 for the 
start of the CONTROL-FIELDS, and column 75 for the start of the PROGRAM-ID 
field. The screen accepts up to 14 truncated lines of RPG Il source code or 7 
full-character lines. 


Enter each line of your code, pressing the TAB FORWARD key to move to the next 
field. At the end of each line, press the TAB FORWARD key to move to the next 
line. When you've entered your entire screen (up to 14 lines), press the XMIT key. 
EDT then displays another RPG Il screen of the same type. 


Keep following one of these methods until you've entered all your RPG Il code. When 
you're finished, you can perform any of the functions described in 10.3.1. 


10.3.3. Entering EDT Commands in Screen Mode 


From any screen mode screen, you can enter any EDT command (except the UPDATE 
command). You enter EDT commands (meaning commands, modifiers, procedure file 
commands, variables, directives, screen commands, and function keys) yon the EDT 
command entry line, which appears on every screen-mode screen. 


On the EDT command entry line, you can enter only EDT commands. EDT flags as 
invalid anything entered from this line except an EDT command. 


Because the command entry line never includes underlines as prompts, you can always 
use the underline in your EDT commands. 
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From any screen, you can enter both source code or data and an EDT command. If 
entering both, EDT places the source code or data in its work space first, then 
processes the EDT command. If you enter neither one and your screens accept single 
record entries, EDT places a blank line in its work space after you press the XMIT key. 


If you want to enter the PRINT command, the CHECK directive, or the ROLL screen 
command specifically to display the contents of EDT’s work space, see 10.3.4. 


10.3.4. Displaying EDT’s Work-Space Contents in Screen Mode 


At any point in your screen mode session, you can display, on your workstation screen, 
the contents of the EDT work space to view the source code or data you've already 
entered. Just as in line mode, you display the work-space contents by entering an 
@PRINT command, an @CHECK directive, or an @ROLL screen command. In screen 
mode, you enter any of these commands on the EDT command entry line that is on all 
screen-mode screens. 


The @PRINT command displays specified lines from the work-space file on the 
workstation screen. The @CHECK directive determines whether EDT should display lines 
that it processed as a result of another EDT command. The @ROLL screen command 
lets you roll through EDT’s work-space file, displaying lines, and if you want, updating 
or correcting them. 


In all cases, EDT displays the work-space contents according to your specification for 
the SCRDSPLY parameter of the @SET directive. If SCRDSPLY=TRUNCATE, EDT 
displays one record per one screen line and truncates lines if necessary; if 
SCRDSPLY=FOLD, EDT displays one record per two screen lines and doesn't truncate 
lines. 


After EDT prints a full screen or the last screen, you have four options: 
1. You may update the displayed lines and transmit them to the EDT work space. 


2. You may continue the PRINT command, CHECK directive, or ROLL screen command 
(i.e., display remaining specified lines) by pressing the F19 function key. 


3. You may prevent the display of succeeding lines by pressing either F1 or F18, then 
pressing the F19 function key. 


4. You may terminate the entire PRINT command, CHECK directive, or ROLL screen 
command by pressing function key F2. 
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® The following is an example of an EDT display if SCRDSPLY=TRUNCATE and you 


an @PRINT command, an @CHECK directive, or an @ROLL screen 


OS/3 EDT (V7.52) EDT TRUNCATE 
He KKK HHH KIRA TKI IKK IEE KEKE KEKE ERE EET REAR EEEEREREKEREKEAEKKEAKERKKE 
Pe ee ee ey ee ee Se ee Pn ee ee, eee: en ree f 
.@00@>DATA LINE 
.9@@O@>DATA LINE 
-99O0O>DATA LINE 
.@900>DATA LINE 
.OO@GO>DATA LINE 
~-OOOOPDATA LINE 
-9800>DATA LINE 
-9O900>DATA LINE 
.9@@O>DATA LINE 
.O9@OO>DATA LINE 106 
.GOOO>DATA LINE 11 
-OOO@PDATA LINE 12 
-O@@@@>DATA LINE 13 
-O@O9O@@PDATA LINE 14 
.900@>DATA LINE 15 
TRANSMIT - Update Lines FK19 - Continue Print 
FK1 - Terminate Print FK2 - Terminate Command 


KKK KKK TKI HK KKK KKK HK KIKI KITE KEE KREREERKRE KHER EEEREEREEEKEEKEEEKKEKKKREREE 


ERROR MESSAGE AREA (2 Lines) 


CON AW EWE 


1 
2 
3 
4 
5 
6 
7 
8 


so 





is an example of an EDT display if SCRDSPLY=FOLD and you issued 


The following 
@& either an @PRINT command, an @CHECK directive, or an @ROLL screen command: 





0S/3 EDT (V7.52) EDT FOLD 


HH KIKI KKK IKK KIKI KEE KEKE REE EKER REE EREKKEEKREREKREEEKEKREREREKEEREKEEEEKEKEKE 


ee eS een Ne ee OR (EARS ee ee, ARS. CL See «MEN Lure ere 
1.09@0rDATA LINE 14 COL128 


2.900@>DATA LINE 2 


3.9@0@0>DATA LINE 3 
data out to column 128 Rk kk KK 

4.0@0Or>DATA LINE 4 

5.Q@0@@rDATA LINE 5 
00000128 


6.990@>DATA LINE 6 
09600 

7.@O@@>DATA LINE 7 
00700 


TRANSMIT - Update Lines FK19 - Continue Print 


FK1 - Terminate Print FK2 - Terminate Command 
HK HK HK KK KK MK HK HI HK TKK KEITH KEKE AER KE KKK KEE EEA REEKERKEKEEEEEEKEKEKEEKESR 


ERROR MESSAGE AREA (2 Lines) 
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10.3.5. Ending Your Screen Mode Session 

After you ve entered all your source code or data, you can either: 

m= end your screen mode session but continue your EDT session in line mode; or 
= terminate your entire EDT session. 


To continue operating in line mode, on the EDT command entry line of your last screen 
mode screen, key in: 


QSET MODE=LINE 


and press the XMIT key. EDT then displays the current line number and positions the 
cursor to accept another EDT command or a data line. 


To terminate your entire EDT session, first enter an @WRITE command to write the 
source code or data you entered in screen mode from the EDT work space to a 
permanent file. Then, enter an @HALT directive to terminate your entire EDT session. 


10.4. SAMPLE SCREEN MODE SESSION 


In this sample screen mode session, we will create a MIRAM data file using the 
screen-mode freeform screen. The file will contain a list of customer names, addresses, 
and account numbers. All your entries are shown in white letters on a_ black 
background. 


ED@6@ EDITOR VERSION 8.@ READY 


z ; ri 
Set Charsyp, Tis  cVU,O0U ma 





After you activate EDT (as we describe in Section 2), EDT displays a message telling 
you that it's ready and displays the first work-space line. You enter an @SET directive 
to set your tab character to a semicolon and to set your tabs at column 20 and column 
60. Setting the tabs lets us format our file into columns containing the names, 
addresses, and account numbers of our customers. You also include’ the 
MODE=SCREEN parameter to enter screen mode. Then you press the XMIT key. 
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OS/3 EDT (V8.4) EOT FREEFORM MULT TRUNCATE 


HHH KKH IKI KKK KEKE KEK KEKE KKK KEK EEK KEK HEE KEKE KKEEEEREEKEKEKEKKEKREKKEEEEKEKUEEE 


0000 
stephen mikowsk1;651 Davis Rd.,Valley Forge,PA;721167 
0000 

0900 
0000 


.0000 (Eimer CECT 171 CUCL ane Rd. 


1. 
2. 
3 
4. 
5 
6 
4 
8 


—_ xt —_ =—_ = 
m~ WN ee Ss Oo 


EDT COMMAND : RIViSRRamenannGtokOl a del t-te ase see.) ee a 
Fe IIT I III MK KIKI ITI RII IIA II ERIK RAIS IIIT TRAIT AIA ER IASI ASAI RARER 


ERROR MESSAGE AREA (2 Lines) 





EDT displays a screen-mode freeform screen and positions the cursor at the first field 
on line 1. You enter each name in your data file, press the semicolon (tab) to tell EDT 
to go to column 20 in its work space, enter each customer’s address, press the 
semicolon key again to go to column 60 in the work space, and enter each customer's 
account number. After each line, you press the TAB FORWARD key to move the cursor 

@ to the next line on the screen. After the eighth data entry, you press the TAB 
FORWARD key to the EDT COMMAND line, where you enter an @WRITE command to 
write your MIRAM data file named CUSTOMER to the disk volume whose serial number 
is relO80. You include the SIZE parameter to allocate the file. Then you press the TAB 
FORWARD key to the bottom rightmost position on the screen and press the XMIT 
key. 
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OS/3 EDT (V8.@) EDT FREEFORM MULT TRUNCATE 


RRA KKEREKEKEKEEHER ERMA KEEKEEUEKRREKREREKKEMEEREEEREREEEKERKKEEREEREKKEREKKEKKEKER 


- 9800 
- 9006 
- 9000 
. 9900 
. 9900 
- 0000 
- 8000 
- 9000 
. 9000 
- 9900 
- 0000 
- 0000 
. 9000 
. 9900 


EDT COMMAND : BRRNEG 


WEEK MKKEKERKKEHEEREMEREERERERKEHEERREREEREKREEKEREERKEKEEEKKEKKKHKEKKEKEKKKKENHKKKKKK 


ERROR MESSAGE AREA (2 lines) 





EDT displays another freeform screen and positions the cursor at line 9 since you 
entered only eight data lines on the previous screen. You press the TAB FORWARD key 
to the EDT COMMAND line and enter an @HALT directive to end your EDT session. 
Then you press the TAB FORWARD key to the bottom rightmost position on the screen 
and press the XMIT key. 
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11. Error File Processing 


11.1. WHAT IS THE ERROR FILE PROCESSOR (EFP)? 


The error file processor, or EFP, is a subroutine of the OS/3 general editor that lets you 
see errors in your source code from the workstation, provided you had your language 
compiler create an error file during compilation. EFP gives you the ability to see your 
source code errors immediately after the language compiler you're using compiles your 
program, rather than after the compiler prints an error listing. 


Because EFP is an interactive product, your source module must reside in a SAT library 
file for you to use EFP to correct it. Your error file, on the other hand, must have been 
allocated as a MIRAM file. 


As soon as you see your errors, EFP lets you correct them using EDT. Because you're 
compiling and debugging your program interactively from your workstation, EFP helps 
improve the turn-around time between compilations. 


Because EFP is a subroutine of the general editor, you can also use EFP in a batch 
environment. See 2.4 for information on using EDT in a batch environment. 


11.2. HOW DOES EFP WORK? 


EFP is a subroutine of EDT that lets you see and correct source code errors without 
having the language compiler output listing. Instead of waiting for your compiler to print 
its listing, you have EFP read your error file. Then, EFP locates the source module to 
which it applies and shows you both the errors and the source code lines that contain 
them. At your workstation, using the EDT commands, you can then correct the source 
code easily and interactively — either one line at a time or several at a time. EFP also 
lets you simply find out what the errors are without correcting them immediately, in 
case you don't have time to fix them all. Later, you can run EFP to redisplay the errors 
and source lines to which they apply and correct them. 
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NOTE: 


lf your source program resides on cards, EFP gives a summary of the program's 
compilation errors; however, you can't correct those errors using EFP. Instead, you 
must correct the cards and recompile your source module. 


Likewise, if you correct your source module using your compiler’s option for correcting 
the module at the same time you're compiling it, you can’t correct its errors using EFP. 
In this case, you may change the correction deck or use either the SAT librarian (LIBS) 
or EDT to correct your source module. The system service programs user 
guide/programmer reference describes the SAT librarian. 


11.3. HOW DO | USE EFP? 


11.3.1. Activating EFP 


You activate EFP using the EDT directive, @EFP. If you're not currently using the editor, 
you key in EDT @EFP. Before activating EFP, however, empty the EDT work space and 
make the current line number and increment equal to 1. To empty the EDT work space, 
use the EDT command, @DELETE. To set the line number and increment to 1 (which 
they are unless you changed them yourself), use the @ command. These items are 
necessary so that EFP can synchronize the errors in the error file with the source lines 
in the source module. | 


Once you activate EFP, it displays the following messages: 


EFP@01 VERSION n.n 


EFP@@2 ENTER ERROR-FILE MODULE -NAME,FILE-NAME,VSN 





where: 


EFPOO1 


Is message that identifies the EFP version number (n.n), for example, 8.0. This 
version number may differ from the EDT version number. - 


EFP@O2 


Is the message requesting that you identify the MIRAM error file for your 
program. Be sure to specify the three items EFP requests in the order they 
appear in the message (module-name, file-name, vsn) and separate them by 
commas. If the error file name (the LBL name of the file) contains commas, 
spaces, or parentheses, enclose it in apostrophes or quotes. After you 
respond to message EFPOO2, press the XMIT key. 
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Using the information you supply, EFP then: 


™ copies the error file to a temporary work file that lasts for the duration of the EFP 
session; 


m identifies the source module for which the error file reports errors; 
™ scans the error file and reports an error summary at your workstation; and 


= displays the following error summary screen: 


EFP@@3 ERROR FILE=error-module-name,error-file-name,vsn 
language-compiler,compiler-version, compilation-date, 
compilation-time ' 


EFP@@4 SOURCE FILE=source-module-name,source-file-name,vsn 
EFP@@5 MODULE=source-module-name nnnn ERRRORS 
or 
program-unit-names 





where: 
EFP 003 
Is the message that identifies the information you supplied in response to 
message EFPOO2, as well as header information that your language compiler 
supplies about the compilation of your program. 
EFP004 
Is the message that indicates the source module you are correcting, as well as 
the file that contains it and the volume that contains the file. EFP automatically 
identifies the source module using your response to message EFPOO2; you 
don't have to specify identification information for the source module. 
EFPQ05 
Is the message that identifies the number of errors EFP reports for either: 
m the source module if you’re correcting a COBOL or RPG II source module; 
or | 
= the program unit names if you're correcting a FORTRAN IV source module. 
NOTE: 


If you're a FORTRAN IV programmer and your compiler processed multiple source 
modules, EFP displays an EFPOO4 message for each source module. Following each 
EFPOO4 message, EFP displays one EFPOO5 message for each program unit in each 
source module. 
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Using the information in EFPOO4, EFP directs EDT to read your source module into the 
EDT work space, which lasts for the duration of the EDT session. Hereafter, you control 
your source module through regular EDT commands and you control your error file 
through EFP commands. Once EFP displays the cursor to you, you can enter any EDT 
command to correct your source module. If you're correcting a COBOL or RPG II source 
program that needs extensive corrections, you can even use the appropriate subeditor, 
either COBEDT or RPGEDT, to fix the errors. 


The important thing to remember is that EFP lets you enter as many EDT commands as 
you want to fix your source code before entering another EFP command. 


The following subsections describe the EFP commands. 


11.3.2. EFP Commands 


There are three EFP commands you can use to control your error file: EFP SUMMARY, 
EFP, and EFP END. To see a workstation display of the three commands, use the EDT 
(@PROMPT screen command with the EDT directive EFP; specifically, key in @PROMPT 
EFP. With this exception only, you can’t combine any EFP command with any other EDT 
commands, nor can you use modifiers with the EFP commands. 


11.3.2.1. Requesting an Error File Summary (SUMMARY) 


The EFP summary command lets you request an error file summary for the source 
module. The format of the summary command is: 


@EFP SUMMARY 


When you issue this command, EFP displays an error summary screen for the source 
module you're correcting. The error summary screen looks like this: 


EFP@@4 SOURCE FILE=source-module-name, source-file-name,vsn 


EFP@05 MODULE= source-module-name nnnn ERRORS 
or 
program-unit-names 





where: 


EFP004 
Is the message that indicates the source module you're correcting, as well as 
the file that contains it and the volume that contains the file. As we said, EFP 
automatically identifies the source module using your response to message 
EFPOO2; you don’t have to specify the identification information for the source 
module. 
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EFP@@5 | 
Is the message that identifies the number of errors EFP reports for either: 


= the source module if you're correcting a COBOL or RPG Il source module; 
or 


m the program unit names if you're correcting a FORTRAN IV source module. 


NOTE: 


lf you're a FORTRAN IV programmer and your compiler processed multiple source 
modules, EFP displays an EFPOO4 message for each source module. Following each 
EFPOO4 message, EFP displays one EFPOO5 message for each program unit in each 
source module. 


After EFP displays the error summary, it positions the cursor to accept another 
command — either an EFP or an EDT command. 


11.3.2.2. Asking EFP to Display Errors (EFP) 


The EFP command lets you display the errors in your error file along with the source 
lines that contain those errors. Note that EFP is both an EDT directive and an EFP 
command. As an EDT directive, it activates the error file processor; as an EFP 
command, it displays errors and the lines that contain them so you can correct them. 


The EFP command has two formats. Format 1 lets you correct and display COBOL and 
RPG Il errors and FORTRAN IV errors for one source module at a time. By using 
Optional parameters associated with Format 1 of the EFP command, you can specify 
exactly which errors you want to see and correct. Format 2 concerns only FORTRAN IV 
programmers who want to see and correct errors for multiple source modules in their 
compilation. COBOL and RPG II programmers never use Format 2. 


Format 1: 


aEFPEXJACprogram-unit-name]A[error-rangeJA['search-string'] 


where: 


Specifies that EFP excludes any errors it already displayed in this execution of 
EFP. When specifying exclusion, don't insert a space between the X and the 
EFP command. 


Without exclusion, @EFP displays the next error in sequence, along with its 
corresponding source line, even if it already displayed the error in this 
execution of EFP. For example, even if you've already seen the third error, 
which applies to line 6 of your source code (which is 100 lines long), the 
(@EFP command tells EFP to display: 


ERR-903 error message 
6.9000 source line 
191.9000 > 
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The cursor ts positioned on line 101 because your source module contains 100 @ 
lines. EFP is ready to accept the next command -— either an EDT command to 

correct the source code or another EFP command. After it displays all the 

errors in your error file, the EFP command without exclusion tells EFP to start 

the process over with the first error in the file. 


With exclusion, @EFPX displays the next error in sequence, along with its 
corresponding source line, but only if it hasn‘t already displayed it in this 
execution of EFP. For example, if you have already seen the third error in the 
error file, the @EFPX command tells EFP not to redisplay the third error, but to 
display the fourth error, which applies to line 12 of your source code: 


ERR-904 error message 
12.9000 source line ' 
191.0000 > 


The cursor is positioned to accept the next command — either an EDT 
command or another EFP command. 


lf EFP has already displayed all the errors and their corresponding source lines, 
EFP displays the message: 


EFP@@6 ALL ERRORS DISPLAYED FOR MODULE source-module-name 
or 
program-unit-name 





> 


Again, the cursor is positioned to accept the next EFP or EDT command. 
NOTE: 


For FORTRAN IV programmers only: If your source module contains multiple 
program units and you specify the X parameter, EFP automatically goes on to 
the next program unit after it displays all the errors and source lines for one 
program unit. In that case, along with message EFPOO6, EFP also displays 
message EFPOO5, the error summary message for the next program unit. 


program-unit-name 
Applies only to FORTRAN IV source modules containing multiple program 
units. This parameter lets you specify to EFP that you want to see and correct 
errors for one specific program unit within your source module. 


Notice that this parameter doesn't let you see errors for multiple source 
modules in your error file. To see errors for multiple source modules, you must 
use Format 2 of the EFP command. 
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_ NOTE: 


lf the name of the program unit is SUM, SUMM, SUMMA, SUMMAR, 
SUMMARY, SOURCE, SOU, SOUR, SOURC, or END, you must enclose the 
program unit name in parentheses. 


error-range 
Displays a range of errors along with their corresponding source lines. You can 
specify a single error, nonconsecutive errors, consecutive errors, or any 
combination. The conventions for specifying the error range are: 


m= Separate nonconsecutive error numbers by commas. 


m™ = Specify consecutive error numbers by giving the first and last errors 
separated by a colon. 


= Specify error numbers in ascending order. 


m Don't specify any error number greater than the number of errors EFP 
reports in message EFPOQ5, which is the error summary message. 


For example, let's say EFP reports 13 errors in your source code. If you 
specify @EFP 2:5,7,11 as your command, then EFP displays only errors 2 

© through 5, and errors 7 and 11. After it displays all the errors, EFP positions 
the cursor for you to correct the errors. 


'search-string' 
Lets you display, by error message text, only those errors of one specific type, 
along with the source lines that contain that type of error. The search string 
can't be longer than 50 characters. 


For example, let's say you've already reviewed your error summary and 
viewed all the errors in your error file. You see that in the data division of your 
COBOL program, the same type of error occurs more than once, namely, 
periods missing in elements. If you specify: 


@EFP ‘PERIOD MISSING IN'' 
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EFP searches the error file, finds that errors 9, 15, and 20 are that particular 
error and lines 16, 19, and 28 of your source code are the lines containing 
that problem. EFP then displays: 


ERR-9009 ‘PERIOD MISSING IN element. PERIOD ASSUMED! 
16.0000 @2 NAME PIC X(25) 


ERR-@015 ‘PERIOD MISSING IN element. PERIOD ASSUMED! 
19.0000 @2 STATE PIC X(2) 


ERR-9020 'PERIOD MISSING IN element. PERIOD ASSUMED! 
28.9000 @2 FILLER PIC X(1) VALUE SPACES 


101.9000 > 


EFP positions the cursor for you to enter an EDT command to correct each 
error individually. The cursor is at line 101 because your source module 
contains 100 lines. When you've corrected all the errors, you can enter 
another EFP command. 


some typical examples of Format 1 follow. They’re based on two separate sample 
situations. 


These examples are based on the following sample situation. Your error file 
contains 20 errors for your COBOL source module. Here’s a list of the source lines 
that contain some of the errors: 


Error 1 applies to line 3 of your source code. 
Error 2 applies to line 6 of your source code. 
Error 4 applies to line 12 of your source code. 


Errors 9, 15, and 20 are all the same type and apply to lines 16, 19, and 20 
of your source code, respectively. 


@EFP 


Displays error 1 in your error file along with line 3 of your source code, even if you've already seen it 


@EFPX 


Displays error 2 in your error file along with line 6 of source code because you've already seen error 1 


@EFP 2:5,7,11 


Displays only errors 2 through 5 and errors 7 and 11, along with the source lines that contain those errors. 


@EFP ‘PERIOD MISSING IN’ 


Displays errors 9, 15, and 20, which are all the same error, along with source lines 16, 19, and 28, 
respectively, because those are the lines that contain those errors 
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S @EFPX 2:5,7,11 


Displays errors 2 through 5, 7, and 11, along with the source lines that contain them, but only if EFP hasn't 
already displayed them 


@EFPX ‘PERIOD MISSING IN’ 


Displays errors 9, 15, and 20, which are all the same error, along with source lines 16, 19, and 28, which 
contain that error, but only if EFP hasn't already displayed them 


m This example is based on the sample situation in which the user's FORTRAN IV 
source modules contain multiple program units. 


@EFP PROGUA 


Displays errors for the specific program unit named PROGRUA in your source module 


Format 2 (for FORTRAN IV compilations of multiple source modules): 


@EFP SOURCE source-module-name,source-file-name,vsn 


source-module-name 
Specifies the name of a specific source module in your FORTRAN IV 
@ compilation that you want to correct. 


source-file-name 
Specifies the name of the source file that contains the source module you're 
correcting. 


vsn 
Specifies the volume serial number of the volume containing that source file. 


Before entering Format 2, first key in an @WRITE command to save the current 
contents of your EDT work space. Then enter an @DELETE command to empty the EDT 
work space. These items are necessary so EDT can synchronize the errors in the error 
file with source lines in your source module. 

Once you enter the EFP SOURCE command, EFP then: 

m= identifies the source module for which the error file reports errors; 


™ scans the error file and reports an error summary to you at your workstation; and 


w displays the following error summary screen: 
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EFP@04 SOURCE FILE=source-module-name,source-file-name,vsn 
EFP@05 MODULE=source-module-name nnnn ERRORS 


or 
program-unit-names 





where: 


EFPOO4 


Is the message that identifies the information you supplied with the EFP 
SOURCE command. 


EFPOO5 
Identifies the number of errors EFP reports for the program units named. 


Using the information in EFPOO4, EFP directs EDT to write your source file to the EDT 
work space, which lasts for the duration of the EDT session. Hereafter, you control your 


source module through regular EDT commands. And, you control your error file through 
the EFP commands. 


A typical example of Format 2 follows: 


@EFP SOURCE MODULE2,SOURCEFILEA,DOO639 
Dispiays errors for the source module (named MODULE2) in your FORTRAN !V source file (named SOURCEFILEA), 
which resides on the volume whose serial number is DOO639 


11.3.2.3. Terminating EFP (END) 

After you've seen or corrected all the errors in your source code, the END command 
lets you terminate your EFP session. Of course, if you don’t have time to correct all the 
errors in one session, you can terminate EFP and reactivate it later to finish correcting 
your source code. 

The format of the END command is: 


@EFP END 


When you specify this command, EFP displays: 


EFP@03 ERROR-FILE=error-module-name,error-file-name,vsn 
language-compiler,compiler-version,compilation-date, 


compilation-time 
EFP@@7 ERASE ERROR-MODULE? (Y,N) 














UP-8828 Rev. 2 SPERRY UNIVAC OS/3 11-11 
GENERAL EDITOR (EDT) 





where: 
EFP003 
Is the message that identifies the error file for your program, as well as header 
information that your language compiler supplies about the compilation of your 
program. 
EFP007 


Is the message that asks if you want to erase the module in your error file 
containing the errors for the module you're correcting. Respond Y for yes if 
you ve seen and corrected all the errors EFP reported; respond N for no if you 
want to go back later and use EFP to finish correcting errors. (Note that EFP 
flags all errors as undisplayed once you terminate EFP). 


After you respond to message EFPOQ7, you can no longer use any EFP command. EFP 
erases the temporary work file that contained the error file for the duration of the EFP 
session. At this time, you must write the corrected source code from the EDT work 
space to a permanent source file, usually its original file. To do this, use the EDT 
(@WRITE command. After you write the file back, you simply issue an EDT @HALT 
directive to terminate the entire EDT session. 


11.4. SAMPLE EFP SESSION 


In this sample EFP session, we will show you how to use EFP for correcting an RPG ll 
source program. This program prints a listing of your employee staff and is named 
STAFPR. The job control stream that compiles your program includes parameters for an 
error file, therefore, you can use EFP to interactively correct compilation errors as soon 
as the compiler successfully compiles your program. 


Here is the source code for your program: 


901 00 010 H STAFPR 
002 01 010 FINDATA IPEAF 80 8@ READER 

903 01 020 FLIST y F 132 132 OF PRINTER 

004 02 910 IINDATA AA 901 

005 2 020 I 1 80 INREC 

906 03 O10 C 01 COUNT ADD 1 COUNT 30 

007 94 010 OLIST H 207 1P 

008 64 620 0 — OR OF 

099 04 0350 0 28 'STAFF FILE LISTING' 
010 04 040 0 D2 01 

911 04 650 0 INRED 80 

G12 94 060 0 T 3 LR 

0135 04 970 0 25 'TOTAL RECORDS LOADED='! 
014 04 080 0 COUNT Z 35 


Notice that the record names on the input specification form on line 5 and the output 
specification form on line 11 don’t match. (We've circled the mismatch.) Of course, in a 
real programming situation, you would be unaware of what errors your program 
contained prior to compiling it. 
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In this example, your entries are shown in white letters on a black background, while 
messages displayed on the screen are shown in black letters on white. 


Step 1 


As soon as your system displays the message telling you that your compilation Job 
terminated normally, you can use EFP to correct your programming errors. You 
activate EDT as described in Section 2 and enter an @EFP directive. Then you 
press the XMIT key. 


ED@@O EDITOR VERSION 8.@ READY 


1. 0000>EREy 





Step 2 


EFP displays a message telling you it’s ready. It requests information about your 
error file, namely, its module and file name, both of which you assigned to the file 
when you wrote your compilation job control stream. It also asks for the volume 
serial number of the volume containing the error file. You key in the information in 
the order EFP requests and then press the XMIT key. 


EFP@01 EFP VERSION 8. 


EFP@O2 ENTER ERROR-FILE MODULE-NAME,FILE-NAME,VSN 
astafpr, erfile, relo8o 





Step 3 


EFP displays the error summary screen for your source program. It consists of 
three messages—EFPOO3, EFPOO4, and EFPOO5 — and a cursor for you to enter a 
command. Message EFPOO3 tells the information abour your error file that you 
supplied in response to message EFPOO2 and information about the compilation of 
your program. Message EFPOO4 tells the module name, file name, and the volume 
serial number of the volume containing your source program. EFPOOS tells the 
number of errors your error file holds for the source module (in this case, two 
errors). EFP copies your source module into EDT’s work space and positions the 
cursor at line 15 because your source code is 14 lines long. You enter an EFP 
command to see both errors at one time. Then you press the XMIT key. 
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EFP@®03 ERROR-FILE=STAFPR,ERFILE,RELO8@ 
RPG II 2051 06/08/82 14:24:00 


EFP@04 SOURCE -FILE=STAFPR,PRGFIL,RELO8@ 
EFP@@5 MODULE=STAFPR $602 ERRORS 


15 .0000> SE ENEF 





m Step 4 


EFP displays both errors it holds for the source module, along with the lines that 
contain the errors. As you study the errors, you see that they are caused by the 
mismatch in the record name that we pointed out at the beginning of this sample 
session. The cursor is positioned at line 15 to accept your next command. You key 
in an @CHANGE command to correct the record name on line 11 and press the 
XMIT key. 


ERR-@001 FIELD NAME (COLUMNS 32-37) IS UNDEFINED. SPECIFICATION IS NOT 
PROCESSED. 
NOTE 174 


0011.0000 040500 INRED 80 


ERR-@@62 WARNING: FIELD NAME IS UNREFERENCED. 

INREC NOTE 205 

2005 .9000 9206201 1 8@ INREC 
econ 11 change 'inred' to ! 





m Step 5 


The cursor is again positioned on line 15 to accept your next command. You know 
that this correction will result in a clean compilation, so you key in an @WRITE 
command to save the corrected source code. You don't have to specify any 
parameters on your command; EDT will automatically write the contents of its work 
space to the module you're correcting. The you press the XMIT key. 


15. COOO>ERREEES 
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= Step 6 


EDT reminds you that your source module already exists and double-checks if you 


want to overwrite it. You want to overwrite it so you respond Y for yes and press 
XMIT key. 


1S10@ STAFPR ,PRGFIL EXISTS; OK TO WRITE TO IT? (Y/N) 





=z Step 7 


EDT positions the cursor on line 15 again to accept your next command. You enter 
an @EFP END command to end your EFP session and press the XMIT key. 


15. 0ooo> RSET 





= Step 8 


EFP redisplays message EFPOO3 telling information about your error file and the 
compilation of your source program. It also displays message EFPOO7, which asks 
if you want to erase the module in your error file containing the errors for the 
source module. You respond Y for yes because you're finished correcting your 
source module, and then you press the XMIT key. 


EFP@@3 ERROR-FILE= STAFPR, ERFILE, RELO8@ 


RPG II 2051 06/08/82 14:24:00 
EFP@O7 ERASE ERROR-FILE? CY, NX> J 





= Step 9 


EFP terminates and EDT positions the cursor to accept your next command. You 


enter an @SYSTEM directive so you can recompile your program without exiting 
from EDT. Then you press the XMIT key. 


£0052 EFP TERMINATED 


15. 000e>QERRID 
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Step 10 


EDT displays a message telling you to enter a system command. You enter the run 
command to run your compilation job, then you press the XMIT key. 


ENTER SYSTEM COMMAND: 





Step 11 


EDT displays another message telling you to enter a system command. You enter 
the RESUME command to continue with your EDT session and you press the XMIT 
key. 


ENTER SYSTEM COMMAND: 





Step 12 


EDT positions the cursor at line 15 to accept another EDT command. At this point, 
you see SYS MSG displayed on the system state line. You press the FUNCTION 
and the SYS MODE keys simultaneously. On the top line of your screen you see 
your original system command, EDT, that activated EDT. On the second line, you 
see messages about the compilation of your program. You press the XMIT key 
after reading each one. When you see the message telling you that your 
compilation job terminated normally, you press the XMIT key once more and EDT 
returns the cursor to line 15 to accept your next command. Enter an @DELETE 
command to empty EDT’s work space. Then press the XMIT key. 


edt 
JC@2 JOB COMPILE TERMINATED NORMALLY 


15. 0000> 
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# Step 13 


EDT empties its work space and positions the cursor on line 1 to accept your next 
command. You enter an @EFP directive to reactivate EFP. Then you press the 
XMIT key. 


1.0000> 





w Step 14 


Again, EFP tells you it’s ready and asks for the module and file name of your file 
and the volume serial number of the volume containing it. You key in the 
information and press the XMIT key. 


EFP@O91 EFP VERSION 8.@ 
EFP@O@2 ENTER ERROR-FILE MODULE-NAME,FILE-NAME,VSN 
aotafpr, erfile, relds& 





m Step 15 


EFP again displays the error summary screen for your program. It shows that your 
error file contains no errors for your source code. So you issue an @HALT directive 
to end both your EFP and EDT sessions. Then you press the XMIT key. 


EFP@O3 ERROR-FILE=STAFPR,ERFILE,RELO8® 
RPG II 2051 06/08/82 14:24:00 


EFP@@4 SOURCE-FILE=STAFPR,PRGFIL,RELO8O 
EFP@95 MODULE=STAFPR 0600 ERRORS 
15.6000 ERT 
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ws Step 16 


EDT reminds you that you didn’t write the contents of its work space to a 
permanent file and asks if you still want to terminate the session. Because you 
made no changes to the source program in EDT’s work space, you don’t have to 
save a copy of it. So you respond Y for yes and press the XMIT key. 


ED@®3 EDITED FILES NOT SAVED - TERMINATE (Y,N)? J 





= Step 17 


EFP then redisplays message EFPOO3 and EFPOO7. You respond Y for yes to 
message EFPOO7 because your program is already error free. Then you press the 
XMIT key and EDT automatically terminates both the EFP and EDT sessions. 


EFP@93 ERROR-FILE=STAFPR,ERFILE,RELO8@ 
RPG II 2051 06/08/82 14:24:00 


EFP@@7 ERASE ERROR-FILE? (CY, N) 
ED0@98 EDT NORMAL TERMINATION 
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12. Error Detection and Recovery 


There are several kinds of errors that may occur during an EDT session. These are: 
= = =command errors; 

= character string, line range, or column range errors; 

m file errors; and 

= workspace file errors. 


Command errors occur when invalid commands are keyed in at the workstation. These 
errors may be detected as soon as the commands are keyed in or after the commands 
have begun to be processed. This, however, depends on the nature of the error. 
Unrecognizable commands and invalid command combinations are detected immediately, 
whereas invalid parameters in commands often are not detected. These errors are 
usually recoverable. 


Errors also result when invalid character strings, line ranges, or column ranges are 
specified in a command. These errors are not detected until the command is processed 
up to that range or until the command is processed through the entire file. 
Consequently, a command may be partially completed before an error is detected. 
These errors are usually recoverable. 


File errors result when the INPUT, READ, or WRITE commands are executed incorrectly. 
These errors are usually recoverable. 


Work-space file errors occur when the contents of the EDT work-space file are lost or 
destroyed. These errors are usually unrecoverable. You should, however, attempt a 
retry to save the EDT work space. Operator intervention may also be required. 


Generally, when an error message is displayed, EDT retypes the current line number on 
the next line. You may then key in the corrected version of the line. 


The error messages displayed describe the situation that caused the error. They also 
suggest possible procedures to correct the errors. 


A complete list of the EDT error messages appears in the OS/3 system messages 
programmer/operator reference. 
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Appendix A. Abbreviations 


Table A-1 contains an alphabetized list of the minimum abbreviations recommended for 
the EDT commands, command options, keywords, command modifiers, EDT procedure 
file commands, EDT variable commands, directives, screen commands, and EFP 
commands. You must key in at least those characters shown, but you may also key in 
additional consecutive characters to improve readability. 


Table A-1. Abbreviations 


ALL A END  £E ON ON 


ASSIGN ENDCOL 




























EN PARAMS PA 






ATSIGN EXCLUDE PRINT 
















































































BLOCK FIND FIN PROC 
BY FIRST F PROMPT 
BUFFER FORMAT FORMAT PUNCH 
~ CHANGE FSTATUS FS READ 
CHAR GOTO G REMOVE 
CHECK HALT H RESTORE 
CLEAR HELP HE RETURN 
COBOL IF iF ROLL 
COLON INPUT INP RPG 
COLUMN INSERT i SEQUENCE 
CONTINUE KEY K SET 
COPY KKEY KK SHOW 
DELETE LINE L STRIKE 
DISPLAY LIST L STRIP 
DO MOVE M SYSTEM 
DROP NOCHANGE N TABS 
EFP (directive} NOP NOP TO 
EFP {command} NOPRINT N UPDATE 
EFP SOURCE NOT NOT WIDTH 
EFP END NUMBER NU WRITE 
EFP SUMMARY OFF OFF 
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Appendix B. Command Processing 
Loop 


The following outline describes the order in which EDT processes a command line. It 
represents the loop through which commands and modifiers are processed. 


1. Input 
a. NUMBER command and data line are read from workstation. 


b. READ and FSTATUS commands are read from permanent file. KEY, KKEY, and 
SHOW options may alter the scope of read. 


c. All other commands are read from work space. Line range may limit scope of 
read. 


2. Search string processing (FIND, REMOVE, COPY, UPDATE, CHANGE, MOVE, 
PUNCH, PRINT, LIST) 


If a search string is specified, it must be found in the line if the line is to be 
processed. The COLUMN modifier limits the search for a search string in the line to 
a specified range. If a search string is specified but not found in the line, 
processing returns to the beginning of the loop to get the next input line. 


3. Change string processing (CHANGE, INSERT, NUMBER, SEQUENCE, REMOVE) 
If a change string is specified or implied (REMOVE) changes are made now. If the 
ALL modifier is specified, all occurrences of the search string are changed to the - 
change string, but if ALL is omitted, only the first change in the line is processed. 


4. Update processing (UPDATE) 


The line is now displayed for updating if UPDATE was specified. If a command is 
entered at this point, the loop may be terminated or processing is altered. 


5. Delete processing (DELETE, MOVE) 


The line is deleted from the input location of the work space and will not be 
rewritten if it has been changed. 
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6. Output to work space 

a. All changed lines are written back to the work space. 

b. Copy lines (COPY, MOVE) are written to the destination. 
7. Show processing (SHOW) 

The line is reformatted according to the specifications on the SHOW option. 
8. Output (WRITE, PUNCH, LIST, PRINT) 


The line is output to a permanent file (WRITE), a spool file (PUNCH, LIST), or the 
workstation (PRINT). 


9. End-of-file processing (FIRST, SEQUENCE, NUMBER) 


This represents the end of the processing loop. The sequence string is incremented 
and the FIRST option is tested. If the FIRST option is specified, the loop terminates 
and end-of-file processing occurs. Otherwise, the loop is reentered to process the 
next input line. 
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Appendix C. Summary of Command 
I/O Operations 
and Options 


Table C-1 shows the input and output locations and the ranges and strings that are 
permitted in each command. 


Table C—?. 1/O Operations and Options for Commands 


EM SERENE LACES IER SERED 
owes fat ff txt | | | tie 















FSTATUS 


INSERT 


NUMBER 


PRINT 


REMOVE 


SEQUENCE 


UPDATE 


WRITE 


LEGEND: 

A Source is work-space file G Output is workstation M Line range allowed 

B Source is permanent file H Output is spool file N Coiumn range allowed 
oe Source is workstation | Update command O Show range allowed 
D Source is to be deleted J Search string allowed P By increment allowed 
E Output is work-space file K Change string allowed X Permitted 





F Output is permanent file = L Destination allowed Required 











ae 
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Appendix D. Comparison of OS/3 
General Editor and 
BEM Editor 


The OS/3 general editor (EDT) is actually an extension of the BEM editor (BEM EDT) 
used in Series 90. However, there are several differences between the two editors, 
which will be discussed here. 


The type of files accessed by EDT is more versatile than BEM EDT. 

EDT can access SAT and MIRAM library files, MIRAM data files, spool files and 
sequential device files (tape, card and diskette files), whereas BEM EDT can access 
only SAT library files. 


EDT uses the colon (:) as the column and line range separator, whereas BEM EDT 
uses the hyphen (-). 


The colon has greater flexibility in OS/3 expression evaluation. Note that EDT 
enables you to change the column and line range separator from the preset colon 
to another symbol via the @SET COLON=range-separator command. 


EDT recognizes #G as the symbol for global variables. BEM EDT uses #. 


The use of #G as the global variable makes EDT easier to use since it eliminates 
the need to specify ## for each # when doing a search operation. 


For example, to change the string IF# TO IF, BEM EDT uses the statement 


@ON & C 'IFH#H' TO 'IF! 


while EDT uses this statement 


@ON & C 'IF#H! TO ‘IF! 


EDT indicates the start column of a found search string by an opening bracket ([). 
BEM EDT uses a percent sign (%). EDT uses a closing bracket (]) to indicate the 
end column of a found search string, whereas BEM EDT has no special symbol for 
the end column of a found search string. 


The use of the symmetric symbols [ and ] gives EDT increased functionality not 
available in BEM EDT. 
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m EDT uses #Gn(x:y) (where x:y denotes the column range) to define a variable @ 
substring. BEM EDT uses #Gn(s,L) (where s denotes the starting column and L 
denotes the length of the substring). 
For example: 
1. @ASSIGN G6='ABCDEFGH' 
2. @ASSIGN G9=! #G66(3:5) 


3. @ASSIGN G9=! #66(3,3) 


Executing 1 and 2 in EDT is equivalent to executing 1 and 3 in BEM EDT. They 
both assign the value CDE to #GQ9. 


m EDT recognizes n(x:y) as the syntax for a line substring, while BEM EDT uses n:x-y. 
For example: 
1. ABCDEFGHIJKL 
2. @ASSIGN G1=1 
3. @ASSIGN G2=#61(5:7) © 
4. @ASSIGN G2=#G61:5-7 


Executing 1, 2, and 3 in EDT is equivalent to executing 1, 2, and 4 in BEM EDT. 
They both assign the value EFG to #G2. 


= The current line number and increment are local for EDT but are not in BEM EDT. 


EDT saves the current line number and increment for each EDT procedure file. BEM 
EDT saves the current line number but always resets the increment to 1 when 
entering or returning from a procedure file. 


m= EDT (using a freeform scan) recognizes as command lines those lines whose first 
nonblank character is a command trigger. BEM EDT recognizes the command 
trigger only in column 1, thus restricting flexibility in structuring commands. 


EDT allows spaces to precede the command trigger and relieves the user of 


worrying whether the command trigger was entered in column 1; thus, it is easier 
to use EDT. 
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m= EDT supports variable-length records and fixed-length records, whereas BEM EDT 
supports only fixed-length records. 


EDT recognizes records up to the current buffer size (128<buffer<2048) and 
optionally strips trailing spaces and X‘OO’s. BEM EDT considers all records to be 
128 bytes. 


The use of variable-length records in EDT allows for expanded record sizes as well 
as more efficient space use for records less than 128 bytes. 


m= EDT and BEM EDT default differently when there is no print option specified on the 
DO command. 


EDT defaults to the print option of the procedure file that called it or to NOPRINT if 
it is called from the main work file. BEM EDT defaults to NOPRINT. EDT allows for 
greater control and flexibility with the PRINT and NOPRINT options on the DO 
command. 


m EDT recognizes and supports the following function keys: F1, F2, F3, F4, F5, F6, 
Fi2, F13, F14, F15 (EOF), F18, and F19. BEM EDT does not recognize function 
keys; however, it does have the same functionality available as F2. There is no 
equivalent for EDT’s F1. 

EDT has more interrupt capability than BEM EDT through the use of function keys. 
= @8€The following BEM EDT commands are not supported by EDT: 


1. @HELP (Note that the @HELP screen command (Section 8) is not the same as 
the BEM @HELP command.) 


2. @RSP 
3. @UPPER 
4. @LOWER 


5. @SET PAGE= 

6. @TYPE 

7. (@DESEO 

Commands 2 and 5 have no equivalent functionality in EDT. Commands 1, 3, 4, 
and 6 have equivalent system commands that can be used. EDT’s keyword KKEY 


has approximately the same functionality as 7, but is more thorough in syntax 
checking. 
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Appendix E. Positional Parameters 
for the READ and 
WRITE Commands 


The READ and WRITE (file) parameters may be entered in a positional format, instead 
of the keyword formats explained in 3.14 and 3.18. In a positional format, only the 
actual parameters for MODULE, FILENAME, VSN, and TYPE are entered; keywords are 
not used. The positional parameters are separated from each other by a comma and 
from the command by a space. The positional parameter format permits compatibility 
with the SPERRY UNIVAC BEM Editor. Four parameters may be entered in the positional 
format in the following order: module-name, filename, volume, module-type. All 
positional parameters are optional; however, if you do not enter the module name, but 
do enter the file name and volume (volume-serial-number), the file name must be 
enclosed in quotation marks (e.g., “‘filename’’). 


Any time you omit a parameter, you still must include a comma to serve as its 
placeholder. 


The following is an example of a positional parameter string in the READ command: 


@READ PAYJOB1,PAYFILE,ABC466,S,DEV=DISKETTE 


This command reads a source module named PAYJOB1 that resides in a file named 
PAYFILE on diskette volume ABC466 to the current work-space file. 


The following is an example of a positional parameter string in the WRITE command: 


@WRITE “PAYROLL” ,ABC466, DEV=DISK 


This command writes a copy of the current work-space file to the file named PAYROLL 
on disk volume ABC466. 
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Appendix F. Command Summary 


F.1. SUMMARY OF EDT COMMANDS 


The formats and explanations for the EDT commands are summarized in Table F—1. 
The commands are listed in alphabetical order. 


Table F-1. EDT Command Summary (Part 1 of 6) 


Line-number [increment]] |: fdata Sets the current line 

+ command number and increment for 
data and command lines 
keyed in at the workstation 


CHANGE aC ['search-string'[*n]] TO 'change-string! [«xn] Replaces an existing 
string in the current 
work-space file with a new 
string 


aCO [lLine-range]['search-string'[«n]] Copies lines in the 
TO destination current work-space file to 


new line locations without 
deleting the original lines 


DELETE aD [line-range]['search-string!' [xn] ] Erases specified lines from 
the current work-space file 


OFIN ‘search-string'[«xn] Locates the first occurrence 
of a string in the 
work-space file and assigns 
its corresponding line number 
to the variable ? and the 
column numbers of the first 
and last columns it occupies 
to [ and ] respectively 





UP-8828 Re 





Command 
FSTATUS 


INSERT 


LIST 


MOVE 


Pra 


PRINT 


Iu 
Ic 
= 
oO 
— 
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Table F—1. EDT Command Summary (Part 2 of 6) 


To specify file parameters for any file for which Creates in the work-space 
you want a list of modules, use this format: file a list of all modules 
contained in a specified 

program library 









,-ILENAME= {filename [,RDPASS=password] 
'filename' 
“filename” 

,VSN=volume 


did 


“ed 





aI ‘change-string! [«n] Inserts a specified string 
into lines in the current 


work-space file 








dL [line-range]{'search-string'[*n]] [IMMEDIATE] Prints specified lines 
from the current work-space 


file on the printer 










aM [line-range]['search-string! [*n]] 
TO destination 


Transfers specified lines 
to new line locations in 

the work-space file and deletes 
the original lines and line 
numbers 


UMBER aNU 'sequence-string'[*xn] [BY increment] Inserts sequence numbers 
into input lines 


aP [line-range]['search-string' [*n]] Displays specified lines 
from the current work-space 
file on the workstation screen 


aPU [line-range]['search-string'[(*n]] [IMMEDIATE] Reproduces specified lines 
from the current work-space 
file on cards 


To read a SAT or MIRAM library module from disk or format Reads a copy of a 
label diskette to the current work-space ftle, use this format: library module or program 


library into the work-space 
a@READ iat lita es tee ae | file 


‘filename! 


eet ema Tet | 
_ “filename” 


[, RDPASS=password] , VSN=volume 


[arse 


KEY=start-col-no:end-col-no | 





KKEY=start-col-no:end-col-no 
SHOWAT irst-col-no:last-col-no 
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& Table F~1. EDT Command Summary (Part 3 of 6) 


READ To read a MIRAM data file from disk or format label diskette 
(cont) to the current work-space file, use this format: 





@READ HeMnee|itona ene 


‘filename! 


"filename™ 






,VSN=volume [cevNo={a] oo id 














A] (KEY=start-col-no:end-col-no 
KKEY=start-col-no:end-col-no 


SHOWAfirst-col-no:last-col-no 





To read a unit record file from a data set label diskette 
or from the card reader, use this format: 






'filename' 


AREAD camel att a 
“filename” 






RDR 


A} (KEY=start-col-no:end-col-no 
KKEY=start-col-no:end-col-no 


SHOWATirst-col-no:last-col-no 


,DEVICE=(did r TRUNC= {ES 
DISKETTE nO 






To read a file from a tape, use this format: 





'filename' 


aREAD eee Hi Toh — 
“filename” 





TAPE 


TRUNC={ BES Al (KEY=start-col-no:end-col-no 
NO KKEY=start-col-no:end-col -no 


SHOWAT irst-col-no:last-col-no 


eg } | Bion feet 
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Table F—1. EDT Command Summary (Part 4 of 6) ®} 


A 


READ To read a file from the spool file to the current work-space 
(cont) file, use this format: 






@READ [JOB=jobname] ant) 
N 
Y 





'filename' 


eee hare ]faserseces-ne 
“filename” 





, QUEUE=(LOG ) rAbL= (TES Sk TPe (a) 
PRINT HO s 


PUNCH 
RDR 









KKEY=start-col-no:end-col-no 
SHOWAT irst-col-no:last-col-no 





[rTRUNC= (nes J*|Reeveeto -col-no:end-col-no | 






To read the same module or file last accessed through 
a previous @READ or @WRITE command, use this format: 






AREAD 


To read the same module or file last accessed through 
a previous @READ or @WRITE command but read now 
with a KEY, KKEY, or SHOW parameter or any valid 
EDT command specified, use this format: 













KKEY=start-col-no:end-col-no 
SHOWATirst-col-no:last-col-no 


[valid EDT command] 


Q@READA;A [icevsstaricoi“nosend-coi | 









@REM ‘search-string'[«n] Deletes a specified 
string from lines in 


the work-space file 











Inserts sequence numbers 
into existing lines in the 
current work-space file 





aSEQ f ogueecere une iemly increment 
* 














aU CLline-range]['search-string' [«xn]] Displays specified lines 
from the work-space file 
one at a time for you 


to edit or change 
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Table F-1. EDT Command Summary (Part 5 of 6) 


WRITE To write the current work-space file to a SAT or MIRAM Writes a copy of the 
library module on a disk or format label diskette, use current work-space file to: 
this format: a program library or data 

file on disk, diskette, or 
@WRITE MODULE=module-name [r2YPE=(pedule- type} tape, or to the spool file 


‘filename’ 


came arti —e 
“filename” 


did 
_ 


a 








a 





To write the current work-space file to a MIRAM data file 
on a disk or format label diskette, use this format: 


‘filename! 


A@WRITE cee ieprei fo eeassrpssever 
“filename” 








,KEYi=[start-col-no:end-col -no 
start-col-no:end-col-no, 


,SIZE=n [*ee te} | i 


Dag} |e BESZ=n! 





To write the current work-space file to a unit record 
file (i.e., to the printer, card punch, or to a data 
set label diskette}, use this format: 


@WRITE FILENAME={filename _VSN=voLlume 
'filename' 
"“filename’™ 
,DEVICE=(did RCEM=| 84% 
DISKETTE 


—— a oe et 
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Table F-1. EDT Command Summary (Part 6 of 6) @ 
WRITE To write the current work-space file to a tape, use 


(cont) this format: 


MWRITE FILENAME= {filename [, WRPASS=password] 
'filename' 
“filename” 
,VSN=volume,DEVICE=fdid 
TAPE 





FIXBLK 
VARUNB 
VARBLK 
UNDEF 





Server | 


NO 


To write the current work-space file to the spooi file, 
use this format: 


AWRITE {40B=jobname] /,HOLD=/ tes} 
NO 


,EILENAME={ filename [,ACCT=acct-no] 
!7iCorone | _ 
“filename” 
,QUEUE={ PRINT MgeTeS tat 
PUNCH = 
RDR 


To write to the same module or file last accessed through 
a previous @READ or @WRITE command, use this format: 


QWRITE 


To write to the same module or file last accessed through 
a previous @READ or @WARITE command, but written to 
now with any valid EDT command specified, use this 
format: 





Q@WRITEA;Avalid EDT command 
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F.2. SUMMARY OF EDT PROCEDURE FILE COMMANDS 


The formats and explanations for the EDT procedure file commands are summarized in 
Table F—2. The commands are listed in alphabetical order. 


Table F-—2. Procedure File Command Summary 


aDO ema lore | Executes a procedure file 





NOPRINT 
REVERT 


Terminates procedure file 
definition 
GOTO aG eae Permits branching within 
Line a procedure file 
I 


NPUT a INP eperanesers| ont ] | Loads and executes a 








NOPRINT 
REVERT 


procedure file 


aNOP ECcomment] Enters extra lines for 
| branching or comments 
into a procedure file 


wv 


ROC aPRO [proc-number] Begins procedure file 
definition 

RETURN aRET Terminates procedure file 
execution 
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F.3. SUMMARY OF EDT VARIABLE COMMANDS 


The formats and explanations for the EDT variable commands are summarized in Table 
F—3. The commands are listed in alphabetical order. 


Table F-3. Variable Cammand Summary 


[Command [Format SSCSC*dYSCSSCS ato 


MAS Gn=('string'[«n] Assigns values to EDT 
n¢(xsy) variables 
n{C+m) 
Gm 

LEN(n) 






























‘string'[«n] Displays a specified 







n¢(x:y) expression or the value 
nC+mj of a specified expression 
Gm from the work-space file 


LEN(n) on the workstation screen 











Permits an EDT command 
or EDT procedure file 

command to be executed 
based on some condition 


@IF.condition. command 





or 








QIF expression relation expression command 
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F.4. SUMMARY OF EDT DIRECTIVE COMMANDS 


The format and explanations for the directive commands are summarized in Table F—4. 
The commands are listed in alphabetical order. 3 


Table F-4. Directive Summary (Part 1 of 2) 


CHECK Determines if processed lines 
| are to be displayed 
on the workstation screen 


COBOL a COB | Activates the COBOL editor 
Deletes ail lines in the 
entire EDT work-space file 


aEFP Activates the error file processor 


FORMAT aFORMAT parameter string (for RPGEDT) Used only in conjunction 
a) FORMAT (for COBEDT) with either RPGEDT or 





COBEDT. See the appropriate 
subeditor manual for information 
on the @FORMAT directive. 


RPG aRPG | Activates the RPG il editor 


as ee tab-character, TABS= {aoa} 










Defines various parameters 
to EDT that collectively 
make up your EDT 
environment 













[,LINE= seclalis | EXCLUDE= gee 





[, ATSIGN=command-trigger][, COLON=range-separator] 


leita! acid ~ idee | 


aaa (lala || 
| OFF 








[, DISPLAY] 


| 


FORTRAN 
COBOL 
RPG 
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Table F-4. Directive Surnmary (Part 2 of 2) 


SYSTEM aSY Cworkstation-command] Permits workstation commands 
to be issued during 


an EDT session or 
temporarily returns you 
to system mode 





F.5. SUMMARY OF EDT SCREEN COMMANDS 


Table F—5 summarizes the formats and explanations for the screen commands. It lists 
the commands in alphabetical order. 


Table F-5. Screen Command Summary 


a 


Displays a freeform 
screen that allows you 
to switch to block mode 
for entering multiple 
commands or data 


HELP @HE [error message code] Displays help screens for 
any EDT error messages 


PARAMS Displays a screen 
showing the parameters on the 
@SET directive (those that 
make up your EDT 
environment) 


aPROM [edt command] 




























Displays the EDT command 
menu screen or help screens 
for any of the EDT commands 
(meaning EDT commands, 
modifiers, directives, procedure 
file commands, variables, and 
screen commands) 




















Returns you to the point in 
your EDT session where you 
originally entered a 

screen command 





Displays freeform screens, 
showing the EDT work-space 
file, where you can update 

lines or simply view them 
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F.6. SUMMARY OF EFP COMMANDS 


Table F—6 summarizes the formats and explanations for the EFP commands. It lists the 
commands in alphabetical order, rather than the order you might use them in. 


Table F-6. EFP Command Summary 


Command | Format Explanation 


To correct and display COBOL and RPG Il errors and Displays errors in your 
FORTRAN IV errors for one source module at a time, use: error file along with 
the source lines. that 
MEF CX]JALprogram-unit-name]JA contain those errors. 
{error-rangeJA Note that EFP is both 
['search-string'] : an EDT directive and 
an EFP command. 


To correct and display FORTRAN IV errors for compilations 
that process multiple source modules, use: 


aEF SOU source-module-name, 


source-file-name, 
vsn 


aEF END Terminates the error 
file processor 
SUMMARY | @EF SUM Displays an error file 
summary for the module 
you're correcting 
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Appendix G. Sample EDT Sessions 


G.1. CREATING A MIRAM DATA FILE IN LINE MODE 


The following example shows you how to create a MIRAM data file using EDT in line 
mode. Here, we activate EDT, enter our data, store our file as a MIRAM data file, and 
then terminate EDT. 


Activates EDT | EDT 


.9090>JO MAXWELL, 22 

.OOOO>KEN FITZPATRICK, 23 

.QOOO>KATHY HOLIDAY, 32 

.9QO@>MICHAEL MAST,35 

.999O0>SHARON PHILLIP,28 

.QOOOPLARRY BERG, 29 

.OOO@>SARA KAFER,51 

.090@>RAY NEUMANN, 56 

.OOOOPAWRITE FIL=DATAFILE, VSN=RELO70, S1=2 
.OOOOPAOHALT 


Our data 


Stores data as MIRAM file 
Terminates EDT 


Oo ODO ON OO WL FWD = 


G.2. UPDATING A MIRAM DATA FILE IN LINE MODE 


The following example shows you how to update a MIRAM data file using EDT in line 
mode. Here, we activate EDT, read in a copy of our file to the work-space file, and then 
display our file. Next, we make our changes, redisplay the file (to ensure that the 
changes have been made) and then store the new version of our file (overwriting the 
previous version). Last, we terminate the EDT session. 


Activates EDT. EDT 

Transfers a copy of our file 1.999@>QREAD FIL=DATAFILE, VSN=RELO7® 

to the work-space file 

Displays the work-space 9.0000>aPRINT 

file 
1.99000>J30 MAXWELL, 22 
2.90O0O>PKEN FITZPATRICK, 23 
3.9@0O@PKATHY HOLIDAY,32 

ee 4.@@90>MICHAEL MAST,35 
5.9@0@>SHARON PHILLIP, 28 
6.900@>LARRY BERG,29 
7.@900>SARA KAFER,51 
8 


.99O9O>RAY NEUMANN, 56 (continued) 


UP-8828 Rev. 2 


Changes 23 to 24 on line 2 
of the work-space file 
Deletes lines 3 and 4 
Displays our updated file 


Our updated file 


Writes our updated file to 

A MIRAM file on disk 
Reminds us that this file 
already exists, and asks if 
we want to overwrite it. We 
select Y, causing the previous 
version of our file to be 
overwritten. 

Terminates EDT 


SPERRY UNIVAC OS/3 G-2 
GENERAL EDITOR (EDT) 


9.Q9000>Q00N 2 CHANGE '23'TO'24' 


9.QOOODADELETE 3:4 

9. 900O>@PRINT 

1.9000>JO MAXWELL ,22 

2.Q00O>KEN FITZPATRICK, 24 

5 .OO0@>SHARON PHILLIP, 28 
6.QOOO>LARRY BERG, 29 

7.Q00@>SARA KAFER,51 

8.0000>RAY NEUMANN, 56 

9. Q00O>OWRITE FILDATAFILE, VSN=RELO70 


IS10@ FILE/MODULE ALREADY EXISTS; 
OK TO WRITE:TO IT? CY,N)DY 


9. 9@OO>OHALT 


G.3. CREATING A USER PROGRAM (SOURCE MODULE) IN LINE MODE 


The following example shows you how to create a FORTRAN IV program using EDT in 
line mode. Here, we activate EDT, enter our source statements, store our program (as a 
source module in a program library), and then terminate EDT. 


Activates EDT 


Source statements 


Lists our file on printer 
Stores our program as a SAT 
file on disk 

Terminates EDT 


EDT 

1.90000>C COMPUTE AVERAGE OF NUMBERS 
2. 9000> KOUNT=0 

3.9000> TOTAL=0 


4.9000> 30 READ(1,10) VALUE 
5.0000> 10 FORMAT (610.0) 


6. 9000> IFCVALUE .GT.9.0E8) GO TO 20 
7 .9000> TOTAL=TOTAL+VALUE 

8. 9000> KOUNT=KOUNT+1 

9.0000> GO TO 30 


10.90000> 2@ XMEAN=TOTAL / KOUNT 

11.9000> WRITEC3,40) XMEAN 

12.0000> 40 FORMAT(' AVERAGE VALUE= ',F10@.5) 

13 .0000> STOP 

14.0000> END 

15.@000>aL IST 

15.990@>aWRITE MO=MYPROG,FIL=MYPROGFILE, 
VSN=RELQ70,SAT=YES,SI=5 

16. @9@OOPOHALT 
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GENERAL EDITOR (EDT) 


G.4. UPDATING A USER PROGRAM (SOURCE MODULE) IN LINE MODE 


The following example shows you how to update a FORTRAN IV program using EDT in 
line mode. Here, we activate EDT and then read in a copy of our source program to the 
work-space file and display it. Next, we make our changes, display the changed 
statements, and then store the new version of our program (overwriting the previous 
version). Last, we terminate EDT. 


Activates EDT EDT 
Transfers a copy of our 1.90000>aREAD MO=MYPROG,FIL=MYPROGFILE, 
file to the work-space file VSN=RELO70 


.99O0O>@PRINT 

.9900>C COMPUTE AVERAGE OF NUMBERS 
. 9O90O> KOUNT=0 

. 9O000> TOTAL=@ 


Displays the work-space file 1 


. 000O> 10 FORMAT (610.0) 


> 
1 
2 
3 
4.9000> 30 READ(1,10)VALUE 
9 
6 
i 
8 


.9000> IFCVALUE.GT.9.9E8)GO TO 20 
. 9000> TOTAL=TOTAL+VALUE 
Our file -9000r KOUNT=KOUNT+1 
9.0000r> GO TO 30 
10.9000> 2@ XMEAN=TOTAL / KOUNT 
11.9000r> WRITE(3,40)XMEAN 
12.0000> 4@ FORMAT(' AVERAGE VALUE= ',F@.5) 
13.0000> STOP 
14.90000> ~ END 
Enters new data line at 15.0000>010.5:C PRINT AVERAGE AND TERMINATE 


line 10.5 

Enters new data line at 
line 1.5 

Displays lines 1.5 and 10.5 


Writes our updated file to 
a SAT file on disk 


Reminds us that this file 
already exists, and asks if 
we want to overwrite it. We 
select Y, causing the pre- 

- vious version of our program 
to be overwritten. 


Terminates EDT 


-6000P01.5:C INITIALIZE COUNT AND TOTAL 


-69000>aPRINT;1.5,10.5 
-5000>C INITIALIZE COUNT AND TOTAL 


10. 


5900@>C PRINT AVERAGE AND TERMINATE 


.6000>@WRITE MO=MYPROG, FILE=MYPROGFILE, 
VSN=RELO70, SAT=YES 


1$10@ FILE/MODULE ALREADY EXISTS: 
OK TO WRITE TO IT? (Y,N)DY 


1.600@>QHALT 
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G.5. CREATING A JOB CONTROL STREAM IN LINE MODE 


The following example shows you how to create a job control stream using EDT in line 
mode. Here, we activate EDT, enter our job control statements, store our job control 
stream as a procedure module, and then terminate EDT. 


Activates EDT 1 
2 
3 
4 
Job control stream 5 
6 
7 
8 
9 
Stores our job control 10 


stream 


Terminates EDT 


.9000r// 
.O000r// 
.900Or// 
-900Or// 
.9900r// 
-9000r / / 
-900Or>// 
-900Or// 
-9900>r/& 


.9O0O>QWRITE MO=JOB1,FIL=JOBFILE, 


10. 


JOB: 
DVC 
LFD 
DvC 
VOL 


MY JOB 

20 

PRNTR 

50 

RELO/7@ 

LBL MYPROGFILE 
LFD SRCLIB 
FOR4LG 


VSN=RELO70, TY=P, SAT=YES, SI=4 
QOOO>AHALT 


G.6. UPDATING A JOB CONTROL STREAM IN LINE MODE 


The following example shows you how to update a job control stream using EDT in line 
mode. Here, we activate EDT and then read in a copy of our job control stream to the 
workspace file and display it. Next, we make our changes, display the changed 
statements, and then store the new version of our job control stream (overwriting the 
previous version). Last, we terminate EDT. 


Activates EDT EDT 


1.000@>AREAD MO=JOB1,FIL=JOBFILE, 
VSN=RELO70, TY=P 


.99O0O>aPRINT 


.9900>// JOB 
-9000>// DVC 
-9000>// LFD 
.99000r// DVC 
.9900r// VOL 
.9000>// LBL MYPROGFILE 
.9000>// LFD SRCLIB 
-9000>// FOR4LG 
.9000Or/& 


-90@0>00N 4 CHANGE 
.@90@>00N 7 CHANGE 


Transfers a copy of our file 
to the work-space file 


— 
S 


Displays our file 


MY JOB 
20 
PRNTR 
50 
RELO/7@ 


Our file 


O CON OW FWD = 


— 
S 


'50'TO'51'! 
'SRCLIB' TO 


Changes 50 to 51 on line 4 
Changes SRCLIB to LIBSRC 


— 
8S 


‘LIBSRC' 


on line 7 


= 
So 


Displays lines 4 and 7 -9O9OO>aPRINT 4,7 
-9000>// DVC 51 


-0000>// LFD LIBSRC 


NOS 


(continued) 
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IG 


Stores our updated file 19. 000O0>POQWRITE MO-JOB1,FIL=JOBFILE, 
VSN=RELO70, TY=P 

Reminds us that this file al- 1S10@ FILE/MODULE ALREADY EXISTS; 

ready exists, and asks if we OK TO WRITE TO IT? CY,NDDY 


want to overwrite it. We se- 
lect Y, causing the previous 
version of our file to be 


overwritten. 


Terminates EDT 10.90000>a0HALT 


G.7. CREATING A MIRAM DATA FILE IN SCREEN MODE 


In this sample screen mode session, we will create a MIRAM data file using the 
screen-mode freeform screen. The file will contain a list of customer names, addresses, 
and account numbers. All your entries are shown in white letters on a_ black 
background. 


ED@¢@ EDITOR VERSION 8.6 READY 





After you activate EDT (as described in Section 2), EDT displays a message telling you 
that it's ready and displays the first work space line. You enter an @SET directive to 
set your tab character to a semicolon and to set your tabs at column 20 and column 
60. Setting the tabs lets us format our file into columns containing the names, 
addresses, and account numbers of our customers. You also’ include’ the 
MODE=SCREEN parameter to enter screen mode. Then you press the XMIT key. 
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OS/3 EDT (V8.6) EDT FREEFORM MULT TRUNCATE 


RRMA REREREKEKKERE KERR KEKEEKEEKREEKEREKEEEKEKEKERKEEKKK KKK 


catherine lorry;63 Tindel Pl.,Blue Bell, 


karen graff;3941) Robert Ave. ,Warminster,PA;391147 
john maxweil;147 Rozel Ave. ,Southampton,PA;?21143 
marie bieska;171 Township Line Rd.,8lue Bell,PA;451689 


1. 
2. 
3. 
4, 
= IP 
6. 
ie 
8. 


HECKER EREKRERRERHEREEMRERE EE EREEEEKEEREEEREREREEREEKKHEEERUEEKEEEEKEEEKERERREEEN 


ERROR MESSAGE AREA (2 Lines) 





EDT displays a screen-mode freeform screen and positions the cursor at the first field 

on line 1. You enter each name in your data file, press the semicolon key to tell EDT to 

go to column 20 in its work space, enter each customer's address, press the semicolon 

key again to go to column 60 in the work space, and enter each customer's account 

number. After each line, you press the TAB FORWARD key to move the cursor to the 

next line on the screen. After the eighth data entry, you press the TAB FORWARD key & 
to the EDT COMMAND line, where you enter an @WRITE command to write your 

MIRAM data file (named CUSTOMER) to the disk volume whose serial number is relO80. 

You include the SIZE parameter to allocate the file. Then you press the TAB FORWARD 

key to the bottom rightmost position on the screen and press the XMIT key. 











OS/3 EDT (V8.0) EDT FREEFORM MULT TRUNCATE 


HHH KAKI KKK KKK KEKE REE KK KEKE KEKE KEREREKEKEKEKEEEKKEEKKEEEUEKRKEKEKKEKEEEKEKKEERES 





eeu swe Lue woe Fae tev ehian we se Fea a ete see Fe wesc oe eee Fee ew eh ewe ewe ew Fe ee Pewee se Fe eee 




















me 
10.0000 


ee ee ee ee ee ee a ee ee ee ey ee ee ee ee ee ee OS SS Se Ee eee Oe eee Kee ee ee 


11.0000 


ar cy ee ese es se ees eg ee ee ce a ee ee ce ye te ee ee ey rey ee ee ey i eee ee ee 


12.9000 


ar ec ee a ae ee ee ee ee ee ee ee ee a eee ee ee ee ee eee ee ee ee ee ee ee 


13.0000 


14.0000 


a ce rr ee cee eee ee kt ee ee ee a ee me le ee le ee oe ee ee 


15.6000 


ee ee ee ee ee eee ee eee eae ee ee ee ee eee ee ee eee ee Ee eee ee ee ee 


16.0000 


— ee ee ee ee ee ee eee eee eee ee eee ee SE ee ee Se eee eee ee eee ee ee ee 


17.0000 


ee ee ee me ee i we ee ee ee re ee eee ye ee ee ey ee ee ee ee ee ee ee ee ee ee a 


LES. 1 | nde Se oe ten amen eens oe EEE, eee ee ee Met ONO SE SSO Ses OO eee eee EA EN er aS 
TOD ara crn he aia att ch ee a ata vm Ey eh eo dt, Saget ells tate 
20.0000 
21.9000 
22. 


ee ee er ee ee ee ee me ee er ce ee ee ee ee ee ee ee ee ea eo es 


i i ee ee 


ae me ee a ee re me me ee ee ee ae ee ee ee ee eee ee ee ee i oe 


mee i ee ee ee ee ee ee re ee ee ee ee ee ee ee ae ee a ee ee EB eee SE ee ee Se 





EDT COMMAND : Gena: 
SECT C TICS TT TTC TTT TCT CITT CTT ITT T eT TCT Pe ST TCT TTP Se Pert ee Pere rr rr 


ERROR MESSAGE AREA (2 lines) 


EDT displays another freeform screen and positions the cursor at line 9 since you @ 
entered only eight data lines on the previous screen. You press the TAB FORWARD key 

to the EDT COMMAND line and enter an @HALT directive to end your EDT session. 

Then you press the TAB FORWARD key to the bottom rightmost position on the screen 

and press the XMIT key. 
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G.8. UPDATING A MIRAM DATA FILE IN SCREEN MODE 


The following sample session shows how you update a MIRAM data file in screen 
mode. The file we'll update is the same file we created in G.7. In this sample session, 
your entries are shown in white letters on a black background. 


ED@@O EDITOR VERSION 8.6 READY 





After activating EDT, you see a message telling you EDT is ready. You enter an @SET 
directive to set your tabs the same way you did when you created the file. You also 
include the MODE=SCREEN parameter to enter screen mode. Then you press the XMIT 
key. 


0S/3 EDT (V8.@) EDT FREEFORM MULT TRUNCATE 


KEKE EHR EEKKEEKKEEEKEEKEKKEKEREKKEKE 


4 
2 
3 
4 
Ds 
6 
7 
8 


KRKEEEKEEKEKKKEEKEERREREKEKEEREEEKEKEREEEKEEAEEKEEEEEAEEKKEKEEEEEEKERAKEKAKKKEKEKKRKK 


ERROR MESSAGE AREA (2 Lines) 





EDT displays a screen-mode freeform screen and positions the cursor at the first field 
on line 1. You press the TAB FORWARD key to the EDT COMMAND line. Then you 
enter an @READ command to read the MIRAM data file named CUSTOMER into EDT’s 
work space. This data file resides on the disk volume whose serial number is relO80O. 
Then you press the TAB FORWARD key to the bottom rightmost position on the screen 
and press the XMIT key. 
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OS/3 EDT (V8.6) EDT FREEFORM MULT 


TRUNCATE 


KKK KEKKEEKREKEKKEEKKKREKEEREEREEKEEKREKEEKKEEKEKKKKKEKEK 


9.9600 
10.0000 
11.0000 
12.0000 
13.9900 
14.0000 
15.0006 
16.0006 
17.9000 
18.9000 
19.8900 
26. 

21. 
22. 


EDT COMMAND : RySSsmRaxd 


RIKER EAR KEKE EEE EK ERE RE KEKE EEK EREEKKEKEKEREEEREEEKEKEKREKEKEEKKEKKEE 


ERROR MESSAGE AREA (2 Lines) 





EDT displays the freeform screen with the cursor at line 9 since the file, CUSTOMER, 
contains eight lines. You press the TAB FORWARD key to the EDT COMMAND line. 
Then you enter an @PRINT command to display your file so you can see where to 
change to it. Then you press the TAB FORWARD key to the bottom rightmost position 


on the screen and press the XMIT key. 


.9@0@>ROBERT ZIMWELL 109 FIFTH AVE.,PHILA.,PA 
.09@@>CATHERINE LORRY 63 TINDEL PL.,BLUE BELL,PA 
.@00@>LORETTA KELLY 5261 HILDEN RD.,PHILA.,PA 
.@O@@>STEPHEN MIKOWSKI 651 DAVIS RD.,VALLEY FORGE,PA 
.@9O0>PAUL CLAYTON 29-46TH PL.,MILLVILLE,PA 
.QOOODKAREN GRAFF 3941 ROBERT AVE.,WARMINSTER,PA 
.0000> JOHN MAXWELL 147 ROZEL AVE.,SOUTHAMPTON,PA 
.O0@0@>MARIE BIESKA 171 TOWNSHIP LINE RD.,BLUE BELL,PA 


oN OW PW SE oo 


ED@04 PRESS TRANSMIT TO CONTINUE ZA 





726113 
511045 
112046 
721167 
721165 


391147 
721143 
451689 


EDT displays the file with your customers’ names starting in column 1, their addresses 
starting in column 20, and their account numbers in column 60. EDT formats its display 
this way because you set and used those columns as tabs when you originally created 
the file in G.7. You note the lines you want to change and what changes you need to 


make. Then you press the XMIT key. 
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OS/3 EDT (V8.0) EDT FREEFORM MULT TRUNCATE 


KKK KIKEE KEKE EKER EERE EERE EKEKEREEERER ERE RERERRKEEEREREEREKEREKEEEREEKRERESE 


-9000 ERE iammerlaka 1-10 Grn is Miclolan delat: cP 2-2 0m Selatel-M oy fob aoe 


EDT COMMAND : BIO) airear late -mee a tk) en co I) 
TET TTT CC TIC CICS CCST TCC STIS SCC SI CIC TSS ECTS Tr TPT Pee eee Serr re 


ERROR MESSAGE AREA (2 lines) 





EDT displays the freeform screen again and positions the cursor at line 9. Now you are 
ready to make changes. You enter three more records to CUSTOMER, pressing the TAB 
FORWARD key after each line. After keying in the third new record, you press the TAB 
FORWARD key to the EDT COMMAND line where you enter an @CHANGE command to 
change Catherine Lorry’s account number from 511045 to 511049. Then you press the 
TAB FORWARD key to the bottom rightmost position on the screen and press the 
XMIT key to pass all of the information on this screen to EDT. 












OS/3 EDT (V8.0) EDT FREEFORM MULT TRUNCATE 


KREG K KKK EEE IKKE KKK KEK IKE KEKE KEK KEKE EEK ERE EK EEKEKCE RE EREKREKEKEEKREKKEERKEEKEEEK 









12.0000 
13.0000 


ee ee ek ee ee eee eee ee ee eee eee eee ae ae i eee ee ee ee ee ee ee ee ee ee ee 


14.9000 


ee ee eee ee ee ee re ee ee ee ee ee ee ee eee ee ee ee ee ae ee ee ee i ee ee ee 


15.8000 


rl ee eee 


16.0000 


ee eee 


17.9900 


ee mr ar ee ee eee ee eee ee eee ee ae ae ee ee a ee eee ee eee ee ee ee ee 


18.9900 


we we ee Se ee eee ee eS eee ee ee eee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee eS = 


19.0000 


20.9000 


eee mee ec ee wre a eee ee eee ee ee ee ee ee ee ee ie ae ee i ee i ee ee 


21.0000 


em ne ee ee ree re er re re eer re ee ee se ee ee ee ee ee ee ee ee i ee a ee ee 


22.0000 


ee eer er ee ee eee ee ee ee ee ee i ee ee ee ee ee ee ee ee ee ee ewe eS eee ee ee = 


PO TOO Oy ohn Sey Sa tr eh te Rt eg ee ts nt eee tn 


CO aaa aca oe a eo ee nie ae a as Na ote Be een ne a 
25.0000 


Sea Eee eee ee ee eee ee ee ee ee eee ee eee eee eS Se eee eee ee ee eee ee ee eee eee oe 
















ee ee eee 








EDT COMMAND : feria me 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkekkkkkkkkekhkkkhkkkkkkKKKKKKKKKKKKK KKK KKK 


ERROR MESSAGE AREA (2 Lines) 


EDT displays another freeform screen and positions the cursor at line 12 since 
CUSTOMER now contains 11 lines. You press the TAB FORWARD key to the EDT 
COMMAND line where you enter an @DELETE command to delete Paul Clayton's 
records (on line 5) from the file. Then you press the TAB FORWARD key to the bottom 
rightmost positon on the screen and press the XMIT key. 
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OS/3 EDT (V8.0) EDT FREEFORM MULT TRUNCATE 


KREGER KEK ERE UKE KEE KEE EER KEE HEE REE HEREREEMREEEEREEEKEKKKKKKEKSE 





Me OO ana oa rs a et ed ee ge AA RAO Fa ect Nae ty 
13.8000 


14.0000 


15.0006 


——— eee ee ee eee ee ee ee ee SB Se eee ee ee eee Se Se Se ee eee ee ee eee ee ee ee 


16.8000 


— re ma re ee eee ee ee ee ee ie ee ee ee ee ee ee ee ee ee ee ee i 


17.0000 


ay mer we a ee te em ee ee rm ee ee ee ee ee eee ee ee ee i i ee 


18.0000 


19.9006 


29.0000 


see ee ee ee ee eee ee ee Se ee ee ee Se eS ee ee Se SS SS ee eee ee eee ee 


21.0000 


———— ee eee ee ee Se ee ee Se ee ee eee ee ee ee SS SS SE BV Se SE ee wee eee eee eS Se ee eee 


22.0000 


CS OOOO ke tc I i ae a a eS i a te Bates Od ee 


PER OOO 6 che NRE ee A a ae Neat 8 et ta oe eh ae Eee date ee 
25. 


eh ee ee eae eee eee 


EDT COMMAND : GSUSRRRES 


KEW E KHER KEKE KEREKEKAKKEMEEKEEKREEEEUKEREKEEEKKKERKKKKKES 


ERROR MESSAGE AREA (2 Lines) 





EDT displays another freeform screen. You press the TAB FORWARD key again to the 
EDT COMMAND line where you enter an @PRINT command so you can see the 
changes. Then you press the TAB FORWARD key to the bottom rightmost positon on 
the screen and press the XMIT key. 


-8OOOPROBERT ZIMWELL 109 FIFTH AVE.,PHILA.,PA 726113 
.O9O9OO>CATHERINE LORRY 63 TINDEL PL.,BLUE BELL,PA 511049 
-O@80O>LORETTA KELLY 5261 HILDEN RD.,PHILA.,PA 112046 
.980@>STEPHEN MIKOWSKI 651 DAVIS RD.,VALLEY FORGE,PA 721167 
-@9O@PKAREN GRAFF 3941 ROBERT AVE.,WARMINSTER,PA 391147 


-9006> JOHN MAXWELL 147 ROZEL AVE. ,SOUTHAMPTON, PA 721143 
-OOOO@PMARIE BIESKA 171 TOWNSHIP LINE RD.,BLUE BELL 451689 
-9900> JOSEPH STENGER 91 NORFOLK DR.,PHILA.,PA 631257 
-980O>SUSAN CANTWELL 193 SORTON RD.,VALLEY FORGE,PA 365491 
-OOOO>KEVIN VEGAS 3914 BLAIR RD.,HORSHAM,PA 921378 


ED@O4 PRESS TRANSMIT TO CONTINUE A 





EDT displays the updated version of your file. You see the three new records, the 


change in Catherine Lorry’s account number, and the absence of Paul Clayton's records 
from the file. Then you press the XMIT key to continue. 
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OS/3 EDT (V8.0) EDT FREEFORM MULT TRUNCATE 


KEKE ARETE KEKE EEKEKEERKEEEKREKKEKCEEREREKREWEREEREKCEREKEEEEERAKEEKEKKKKKEKKEKEK 


12. 
13. 
14. 
15. 
16. 
17. 
18. 
19. 
2¢. 
21. 
22. 
23. 
24, 
25. 


EDT COMMAND : BIRR MUereatichael | tone lace ae elel® 
KREUK EEEEKREKEREEKERAERRERAEEKKEEKUEKEERREEEKEKHKHEERKEEEEEKEKKKEKAHEEKE 
ERROR MESSAGE AREA (2 Lines) 





EDT displays another freeform screen. You press the TAB FORWARD key to the EDT 
COMMAND line where you enter an @WRITE command to write your file back to the 
disk volume. Then you press the TAB FORWARD KEY to the bottom rightmost position 
on the screen and press the XMIT key. 


1$106 CUSTOMER EXISTS; OK TO WRITE TO IT?¢Y,N) J 





EDT reminds you that your file already exists and double-checks if you want to 
overwrite it. You want to overwrite it, so you respond Y for yes and press the XMIT 
key. 
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OS/3 EDT (V8.0) EDT FREEFORM MULT FRUNCATE 


HK RHA K KR KKK EKER EK KHER EEK EEE REE EKEKEEKEKREEKREKEKEKEKERKEKEEEEEKEEKREKKKEK 


. 0060 
. 9060 
. 9000 
. 9000 
. 9000 
. 9900 
- 9000 


EDT COMMAND :fineuiie 
KHKKEKKKKKKEKKEK KKK KEKE KKK KEKE KEKE KKKEKEKEKEKEKEKEKKKKEKKKKKKKKKKKKRKRKK 


ERROR MESSAGE AREA (2 (ines) 





EDT displays another freeform screen and positions the cursor at line 12. You press 
TAB FORWARD key to the EDT COMMAND line and enter an @HALT directive to end 
your EDT session. Then you press the TAB FORWARD key again to the bottom 
rightmost position on the screen and press the XMIT key. EDT terminates. 


G.9. UPDATING A USER PROGRAM (SOURCE MODULE) IN SCREEN MODE 


The following sample session shows how you update a COBOL source program in 
screen mode. In this session, we'll update the same program we updated in Section 2. 
And we'll make the same changes to it. The difference is that this is a screen mode 
session and the session in Section 2 is a line mode session. 


Because we recommend you use screen mode for updating, not creating, either COBOL 
or RPG Il source programs, here we'll show only an updating session. Keep in mind that 
you can create a COBOL source program either in EDT line mode or, better yet, using 
the COBOL editor, COBEDT. 


f 


If you remember, our program LABELS prints address labels for magazines, like this: 


NAME 


ADDRESS 
CITY STATE ZIP 
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©} We're going to update LABELS to double-space the lines and include an account 
number next to the name, like this: 


NAME 


ADDRESS 





CUuLyY 





In this sample session, your entries are shown in white letters on a black background. 





After activating EDT, you see a message telling you EDT is ready. You then enter an 
(@READ command to read your source module LABELS to the EDT work space from the 
file named MAGAZINE on the volume whose serial number is USERO1. Then you press 


the XMIT key. 


ED@@@ EDITOR VERSION 8.@ READY 
1.0000>ar MO=LABELS, FILE=MAGAZINE, VSN=USERO1 


51. 000erey 





EDT copies the module into its work space and positions the cursor at line 51 since 
LABELS contains 50 lines of source code. You enter an @PRINT command to display 
LABELS on your workstation screen and press the XMIT key. 
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—_-O———— CC er ee 


- 9060aP 

-O@80OP> IDENTIFICATION DIVISION. 
-@800>PROGRAM-ID. LABELS. 
-@OOO>ENVIRONMENT DIVISION. 
-9800>CONFIGURATION SECTION. 

- 9800> SOURCE - COMPUTER .UNIVAC -0S3. 
-9900>0B JECT -COMPUTER.UNIVAC-OS3. 
.@800> INPUT-OUTPUT SECTION. 
-900@>FILE CONTROL. 

.@BOG>SELECT CARDIN, ASSIGN TO CARD READER-CARDIN-F. 
-OOOO>SELECT PRINTOUT, ASSIGN TO PRINTER-PRINTOUT-F. 
-@8O00PDATA DIVISION. 

-O9O@0O>FILE SECTION. 

.9O000>FD CARDIN 

- 9900> LABEL RECORDS ARE OMITTED. 
-9900001 CARD-INPUT. 

. 9000> $2 NAME PIC X¢€25). 

- 9900> @2 STREET PIC X¢25). 

. 9900> @2 CITY PIC X¢15). 

- 9000> @2 STATE PIC X(2). 

- O800> @2 ziIP PIC X¢5). 

- 9000> @2 FILLER PIC X¢&). 
-@000>FD PRINTOUT 

- 80005 LABEL RECORDS ARE STANDARD. 


On OU SF WN = = 


—_ 
oe © 


11 


Nm nN hw Nw eo om ow mm Rm ee et 
WN =| BOON Ow & WN 





EDT displays the first 23 lines of LABELS on your workstation screen. You note the 
lines that require updating and press the F19 function key, while pressing the FUNCTION 
key, to see succeeding source code lines. 


-0600°0% PRINTLINE PIC X(29). 

- O9OOOPWORKING-STORAGE SECTION. 

.9800>01 CITY-STATE-ZIP-LINE. 

- 98OG> @2 CITY-OUT PIC X¢(15). 

- 9O@Or @2 FILLER PIC X¢€1) VALUE SPACES. 
. 6900> @2 STATE-OUT PIC X(2). 

- 0000> @2 FILLER PIC X(€2) VALUE SPACES. 
. 9800> 2 ZIP-OUT PIC X(5). 
-9800>PROCEDURE DIVISION. 

- 9900>BEGIN- JOB. 

. 9000> OPEN INPUT CARDIN, OUTPUT PRINTOUT. 

. 99OO>READ-CARD. 

. 98O0r READ CARDIN, AT END GO TO END-OF-JOB. 
- 9OOOr MOVE SPACES TO PRINTLINE. 

- 9OOGr WRITE PRINTLINE. 

- 9000> MOVE NAME TO PRINTLINE. 

- 9800 WRITE PRINTLINE. 

. 9O8O> MOVE STREET TO PRINTLINE. 

. O98O> WRITE PRINTLINE. 

- 9000> MOVE CITY TO CITY-OUT. 

. 9000> MOVE STATE TO STATE-OUT. 

- 9600> MOVE ZIP TO ZIP-QUT. 

- 9000> WRITE PRINTLINE FROM CITY-STATE-ZIP-LINE. 
- 99000 GO TO READ-CARD. 





EDT displays lines 24 through 47 of LABELS. Again, you note where to make changes 
and press the F19 function key to see the last three lines of LABELS. 
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. 900O> @2 FILLER PIC X(1) VALUE SPACES. 
- 9000> @2 STATE-OUT PIC X¢2). 

- 9900> @2 FILLER PIC X(2) VALUE SPACES. 
. 8900> @2 ZIP-OUT PIC X(5). 
.@09G>PROCEDURE DIVISION. 

- @90O>BEGIN- JOB. 

- 0O80r OPEN INPUT CARDIN, OUTPUT PRINTOUT. 

- @@GOPREAD-CARD. 

- 0O00> READ CARDIN, AT END GO TO END-OF-JOB. 
- 8900> MOVE SPACES TO PRINTLINE. 

- 0000> WRITE PRINTLINE. 

. 900> MOVE NAME TO PRINTLINE. 

. 990O> WRITE PRINTLINE. 

. 8000r> MOVE STREET TO PRINTLINE. 

. O600> WRITE PRINTLINE. 

. OO0Or MOVE CITY TO CITY-OUT. 

. 9O0Or MOVE STATE TO STATE-OUT. 

. 9O00> MOVE ZIP TO ZIP-OUT. 

- 9000> WRITE PRINTLINE FROM CITY-STATE-ZIP-LINE. 
- 9000e GO TO READ-CARD. 

- @90O>END-OF - JOB. 

- 989Or> CLOSE CARDIN, PRINTOUT. 

- O800r> STOP RUN. 


. 0190 O> REPS ele l- er -tok lek aan ote ale a -e- Daler er-let-t-sene] ered 





EDT scrolls the lines up and displays the rest of LABELS. It positions the cursor at line 
51 to accept an EDT command. You check if the last three lines of LABELS require 
changes, then enter an @SET directive to enter screen mode. You include the 
RECENTRY =SINGLE parameter because you'll be updating one line at a time. You also 
include the LANGUAGE=COBOL parameter to use a COBOL screen. Then you press the 
XMIT key. 


0S/3 EDT (V8.0) | | EOT COBOL SINGLE TRUNCATE 


RKEKKEKKEKEEREKEEREKREKEKEKEREEKREKEERERKEEKRERRREEEEREEEEKEREREEARREEKREEREREEKEEREREERERE 


2 cae atte Ss acute SP a ee ok we Oa ow eal eee ee bee sen Eee rie ee oer 


LINE # SEQUENCE CONTINUATION TXTA 
51.0000 


IDENTIFICATION 


EDT COMMAND : Aiifenicwi mM femeel one 


He HH IIH TK KIKI II HTK II IIT HK III THEI ITI HMI AIH IIIA TEAMMATE TAIRA 
ERROR MESSAGE AREA (2 Lines) 





EDT displays the COBOL screen mode screen. It positions the cursor at line 51, ready 
to accept an entry for the SEQUENCE field. You press the TAB FORWARD key to the 
TXTB field and key in your new source line, making sure that the line is spaced 
properly. Then you press the TAB FORWARD key to the EDT COMMAND line where 
you enter an @MOVE command to move the line you just keyed in to line 16.5. After 
tabbing to the bottom rightmost position on the screen, you press the XMIT key. 
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OTN ee AE SSP pS er PE 


OS/3 EDT (V8&.) EDT COBOL SINGLE TRUNCATE 


WERKE KUUEEEEEEEERERRERRRERKEKKERREREERREKEERERERKERAREEERERERREREREREREKEEKES | 


51.0000 @2 ACCT-NO PICX(4). 
LINE # SEQUENCE CONTINUATION TXTA 
52.0000 


EDT COMMAND : fifelaieaiiinelallalel-means Rn aon a 
PEKEKEKEKEKKEKKEKEKERRKEEEKAEKEEEEEEKCEKUERAKCRERAMERERERREREERREREEERRERRRREREREEAREE 
ERROR MESSAGE AREA (2 Lines) 





EDT displays the same COBOL screen again, except that it now shows the new source 
line you just added. Because LABELS now contains 51 source lines, it positions the 
cursor at line 52. You tab to the EDT COMMAND line and enter an @CHANGE 
command to change the 8 on line 21 to a 4. Then you press the TAB FORWARD key 
to the bottom rightmost position of the screen and press the XMIT key. 


OS/3 EDT (V8.¢@) EDT COBOL SINGLE TRUNCATE 
RERMMUECKAEKREKEEREKREKKKREREARERERERREKKAEEKEKEKEKEKKEERAEKEEECREEREREKERARKRERKEAKEARER 
ee ere Deen ener OER, (SEE, ALY “ORE AREA EA. SERS RES « CN EN 6 
51.0000 @2 ACCT-NO PICX(4). 
LINE # SEQUENCE CONTINUATION TXTA TXTB 
52.9000 MOVE ACCT-NO TO PRINTLINE. 





TXTB IDENTIFICATION 


EDT COMMAND : Piliiteh acelin memes a abs 


KEKE IKE KEKE EKER KEKE HEEEERERREKEMERUCREKMEEEERKREKEEKREKERREKMEEKEEKKEEREMKEAKEKK 


ERROR MESSAGE AREA (2 lines) 


ee ene, 
+ ee 


On this COBOL screen, you enter a new source line in the TXTB field. Then you press 
the TAB FORW’ARD key to the EDT COMMAND line where you enter an @MOVE 
command to move t!.e new line tu line 39.5. After pressing the TAB FORWARD key to 
the bottom rightmosi position -n the screen, you press the XMIT key. 
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nn 


0S/3 EDT (V8.@) EDT COBOL SINGLE TRUNCATE 


KIKI KIKI AKEMIUITERARERREEEREAEREREEEREEEERREREEREREERRUEUREEEEEEREREEEEREREREEK 


51.0000 - @2 ACCT-NO PICX¢4). 
52.0000 MOVE ACCT-NO TO PRINTLINE. 
LINE # SEQUENCE CONTINUATION TXTA TXTB 


53.0000 7 set the MOVE SPACES TO PRINTLINE. 


IDENTIFICATION 


EDT COMMAND : Gite e aC Ii Some: ere a oe 
HH HICK HH KEK IK TT IT TI IARI MET TTR IK IIIT RIK IAAI IAA IAI SET IAI IATA AIIM ATA AIIM IANA 


ERROR MESSAGE AREA (2 Lines) 





On this screen, you add a new source line starting in the TXTB field. Then you enter an 
@COPY command to copy it to three different places in your program: lines 40.2, 42.2, 
and 46.2. Then you press the XMIT key. 


& 0$/3 EDT (V8.0) | EDT COBOL SINGLE TRUNCATE 


HHI MK MIKE EEREEEERREREKREKEEEEEKERKEEREEEKEKEEREKEEREEEKKKKKKRRKKKKN 


Sven Pewee tie tPs ce vevads Panes oe ee hoyneees se Penns Orsas Mere cOeceePeeder 


51.0000 @2 ACCT-NO PICX(4). 
52.0000 MOVE ACCT-NO TO PRINTLINE. 
53.0600 MOVE SPACES TO PRINTLINE. 
LINE # SEQUENCE CONTINUATION TXTA TXTB 


54.0000 : Sos | 
IDENTIFICATION 


EDT COMMAND : Bileelst ue) gene) a-) ane we come 


KERKEKEKRKKEEKERKEREEEEKKEKEEUEEEREEREEKEKEREKKKEEEKERREEEEEEEMEKREREEEEREKKKEKKEKEKEK 


ERROR MESSAGE AREA (2 lines) 





You key in another source line and copy this one also to three places in your program. 
Then you press the XMIT key. 





UP-8828 Rev. 2 SPERRY UNIVAC OS/3 G-18 
GENERAL EDITOR (EDT) 


0S/3 EDT (V8.0) EDT COBOL SINGLE TRUNCATE 


RRMA KCK REREREREEEEREEERARREREKERERAAARAEEHERRERERAEEREREEEEARRERRANERE 


ee, een eres, a ee or ee eee ee ee, ee eee ee. eee ee f 


31.0000 @2 ACCT-NO PICX(4). 
52.0000 MOVE ACCT-NO TO PRINTLINE. 
53.0000 MOVE SPACES TO PRINTLINE. 
54.9000 WRITE PRINTLINE 

LINE # SEQUENCE CONTINUATION TXTA 
55.0000 


IDENTIFICATION 


EDT COMMAND : Emenee 
ERA REAR EERE AEE HERR ERERERERRERREREREEREEERAEHERERREREEREREREEEEAEEEDEEED 


ERROR MESSAGE AREA (2 Lines) 





You have no more source lines to add, so you press the TAB FORWARD key to the 
EDT COMMAND line. Because you've already copied lines 53 and 54 to their correct 
lines, the last change you must make is to delete lines 53 and 54 from EDT’s work 
space. So, you enter the @DELETE command. Then you press the XMIT key. 


0S/3 EDT (V8.@) ' EDT COBOL SINGLE TRUNCATE 


RERRERERERERRREREERERERRRREEREREERERERERERRERREEEEETUEAREREERAEERNHEEHHREEEEER AER 


31.9000 @2 ACCT-NO PICX(4). 
32.0808 MOVE ACCT-NO TO PRINTLINE. 
33.0800 MOVE SPACES TO PRINTLINE. 
54.9000 WRITE PRINTLINE. 

LINE # SEQUENCE CONTINUATION TXTA 
55.0600 


IDENTIFICATION 


EDT COMMAND : fisiaaiahemeraeeon 
Bee te He RRR EERE REE EERE EEE RANE AERERERTEREAHAERAE ERED 


ERROR MESSAGE AREA (2 Lines) 





Now that you’ve made all your changes to your program, you issue an @PRINT 
command to make sure you made the changes correctly. First you tell EDT to display 
lines 12 through 31 by issuing @PRINT 12:31. Then you press the XMIT key. 
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-OOOO>FILE SECTION. 
13.6000>FD CARDIN 
14.0000> LABEL RECORDS ARE OMITTED. 
15.0000>01 CARD-INPUT. 

















16.0660> @2 NAME PIC X(25). 
16 .5000> @2 ACCT-NO PIC X(4). 
17 .9000> @2 STREET PIC X¢(25). 
18.060¢r @2 CITY PIC X(15). 
19. 900O> @2 STATE PIC X(2). 
20. 9000> @2 ZIP PIC X(5). 
21.0000> @2 FILLER PIC X(4). 


22.0000>FD PRINTOUT 

23.9090> LABEL RECORDS ARE STANDARD. 
24.0000>01 PRINTLINE PIC X(29). 
25. OOOO>WORKING-STORAGE SECTION. 
26.9000P01 CITY-STATE-ZIP-LINE. 
27.9000> 2 CITY-OUT PIC X(15). 


28 . 0600r @2 FILLER PIC X(€1) VALUE SPACES. 
29. 0900> @2 STATE-OUT PIC X(2)>. 
30 .9000> @2 FILLER PIC X(2) VALUE SPACES. 


31.0000> @2 ZIP-OUT PIC X(5). 
ED@@4 PRESS TRANSMIT TO CONTINUE 






EDT displays the lines so you can see the new line added on line 16.5 and the change 
on line 21. You then press the XMIT key to continue. 


OS/3 EDT (V8.6) EDT COBOL SINGLE TRUNCATE 


REEMA HEKKEEERRERAKKEERREEKEEKEUMEKEKKKEREKREEEREEEKCERAEEEREKHEEEKEEERKEKREKKHKKRRKKK 


LINE # SEQUENCE CONTINUATION TXTA 
55.0000 . 


IDENTIFICATION 


EDT COMMAND : Signin aR 


RHR KK KKK KEKE MRE KEKE KK KEKE KEKE KEEKEEREKREREKEAKEKKEKEKEEKREEEEKKEKKEK 


ERROR MESSAGE AREA (2 Lines) 





EDT displays another COBOL screen where you press the TAB FORWARD key to the 
EDT COMMAND line. Once the cursor is there, you enter a @PRINT command to see 
the other lines you made changes to. Then you press the XMIT key. 
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39 .O660> MOVE NAME TO PRINTLINE. 

39 .5060> MOVE ACCT-NO TO PRINTLINE. 
40. 8000> WRITE PRINTLINE. 

4%.2000> MOVE SPACES TO PRINTLINE. 
40.4000> WRITE PRINTLINE. 

41.8000> MOVE STREET TO PRINTLINE. 
42.9000> WRITE PRINTLINE. 

42 .2060> MOVE SPACES TO PRINTLINE. 
42.4000> WRITE PRINTLINE. 

43.9000> MOVE CITY TO CITY-OUT. 
44.0000> MOVE STATE TO STATE-OUT. 
45 .0000> MOVE ZIP TO ZIP-OUT. 

46 .9000> WRITE PRINTLINE FROM CITY-STATE-ZIP-LINE. 
46.2000> MOVE SPACES TO PRINTLINE. 
46.4000> WRITE PRINTLINE. 

47 .4000> GO TO READ-CARD. 
48.90@00>END -OF - JOB. 


ED@O4 PRESS TRANSMIT TO CONTINUE 





EDT displays the lines and you see that it added the new lines on 39.5, 40.2, 40.4, 
42.2, 42.4, 46.2, and 46.4. You press the XMIT key to continue. 


0S/3 EDT (V8.0) EDT COBOL SINGLE TRUNCATE 


KKH IRE KERR ERIK EAE KK EREAREREREEKEEEREREEERREREREREEEEREAEREMERUREREEEEHEEEE 


i eile se at res De Si ee ok ee ee ie Oe ies Pa gee Oeea shana mn’ 


LINE # SEQUENCE CONTINUATION TXTA 
25.0000 


IDENTIFICATION 


EDT COMMAND : Wiitebn er )e)on@ceinane Gtur-lel- Pan lal a TRese T sao 


eer ere rt Perr rrr rr rrrrrr errr irre r Serr rere rT rr LTT TTT ST TT TE CT TT TTT FP he SSO 


ERROR MESSAGE AREA (2 Lines) 





EDT displays another COBOL screen. You press the TAB FORWARD key to the EDT 
COMMAND line and enter an @WRITE command to write your program back to the 
disk volume. Then you press the TAB FORWARD key to the bottom rightmost position 
on the screen and press the XMIT key. 
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18100 LABELS EXISTS; OK TO WRITE TO IT?(Y,N)]j 





EDT reminds you that your program module already exists and double-checks if you 
want to overwrite it. You want to overwrite it so you respond Y for yes and press the 
XMIT key. 


0S/3 EDT (V8.0) EDT COBOL SINGLE TRUNCATE 


eee TT Tr errr rrr rr errr rrrrrererecrr rrr rrr PEP SPST TT ET FP TT Ce TTF Ah Ek 


LINE # SEQUENCE CONTINUATION TXTA 
55.0000 


EDT COMMAND : BREMG 


KKK IK KICK KE EKER ERIK IERIE IKKE KRAEMER KER EERE EEE KEE EEEEEEKKEKKEEKEKN 


ERROR MESSAGE AREA (2 Lines) 





On the next COBOL screen, you press the TAB FORWARD key to the EDT COMMAND 
line and enter an @HALT directive to end your EDT session. Then you press the TAB 
FORWARD key to the bottom rightmost position on the screen and press the XMIT 
key. EDT terminates. 
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accessing 5.9 5-12 os 
5.2 9-3 Erasing data See @DELETE 
5.5 5-8 command. 
creating 5.9 9-12 
5./ 5-11 Error file processor (EFP) 
executing 5.9 5-12 activating 11.3.1 ll- 
a2 5-3 correcting COBOL screen modules 11.3.1 ll- 
5.5 5-8 correcting FORTRAN IV 
saving 5.9 5-12 source modules 11.3.2.1 11-4 
correcting RPG | 
EDT processing loop Appendix B source modules 11.3.1 11-3 
directive to actuate 75 7-6 
EDT sessions, samples 22 2-4a displaying errors 11.3.2.2 11-5 
Appendix G FORTRAN IV errors for multiple 
source modules 11.3.1 11-3 
EDT variables FORTRAN IV errors for single 
assigning values 6.2 6-2 source modules 11.3.1 11-3 
displaying values 6.3 6-4 multiple program units 11.3.2.1 11-5 
format 6.1 6-1 
using 6.1 6-1 Errors 
6.5 6-8 correcting errors in source 
modules with EFP Section 11 
EDT work-space file See work-space detection and recovery Section 9 
file. excluding display of errors 
with EFP 11.3.2.2 11-5 
@EFP command messages requesting help 8.3 8-5 
examples 11.3.2.2 l range 11.3.2.2 11-7 
explanation 11.3.2.2 11-5 requesting file summary See @EFP 
formats 11.3.2.2 ] SUMMARY. 
RPG Il 11.3.2.2 11-5 
@EFP directive search text 3 2.2 11-7 
activating EFP 11.3.1 11-2 Summary screen 11.3.2.1 11- 
description 75 7-6 
format r5 7-6 Exclusion character, defining 7.9 7-10 
help screen 75 7-6 
Executing an EDT procedure file 5.2 5-3 
5.5 5-8 
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F G 
@FIND command General editor See EDT. 
examples 3.6 . 
explanation 3.6 3-13 #Gn 
format 3.6 3-13 description 6.1 6-1 
help screen 3.6 3-13 use 6.1 6-1 
used with modifiers 3.6 3-14 | 6.2 6-3 
used with other commands 3.6 3-14 6.3 6-5 
6.4 6-7 
Finding data See @FIND 6.5 6-8 
command. 
@GOTO command 
FIRST modifier examples 5.4 5-6 
examples 45 4-6 explanation 5.4 5-6 
explanation 45 4-§ tormat 5.4 5-6 
help screen 5.4 5-6 
@FORMAT command 7.6 /-6a 
FORTRAN IV screens 
CONTINUATION field 10.2.4 10-6 
IDENTIFICATION field 10.2.4 10-6 
LABEL field 10.2.4 10-6 
preset fields and tabs 10.2.4 10-6 
samples 10.2.6.2 10-10 
specifying in screen mode 79 7-13 
STATEMENT field 10.2.4 10-6 
Freeform screens ri 
entering data or assembler code 10:3:2.1 10-17 
sample screens 10.2.6.1 10-9 @HALT directive 
setting tabs 10.3.2.1 10-17 explanation 77 7-] 
specifying in screen mode 7.9 7-13 format 77 1-7 
10.1 10-1 help screen 7] /-] 
10.2.4 10-6 
@HELP screen command 
@FSTATUS command explanation 8.3 8-5 
examples 37 3-17 format 8.3 8-5 
explanation 37 3-15 function key equivalent 8.3 8-5 
format | 3.7 3-17 Section 9 
help screen 3.7 3-15 help screen 8.3 8-5 
use with other commands 3.7 3-17 sample 8.3 8-6 
Function keys Section 9 Help screens 
EDT error messages 8.3 8-5 
description 1.3 1-9 
conventions 8.5 8-10 
@PROMPT 8.5 8-9 
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Term 


@IF command 
examples 
explanation 
format 
help screen 


Increment 
description | 
setting increment for work-space 
line numbers 


Initializing EDT 


@INPUT command 
example 
explanation 
format 
help screen 


@INSERT command 
examples 
explanation 
format 
help screen 
used with modifiers 
used with other commands 


Inserting data 


Inserting sequence numbers 
into input lines 
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6.4 6-7 
6.4 6-6 
6.4 6-6 
6.4 6-6 
1.3 1-7 
3.2 3-3 
ZA 2-]} 
5.5 5-9 
55 5-8 
55 5-8 
55 5-8 
3.8 3-18 
3.8 3-18 
3.8 3-1 
3.8 3-18 
3.8 3-19 
3.8 3-19 
See @INSERT 
command. 

3.11 3-25 


Term 


Label, description 


Language 
specifying in screen mode 


FREEFORM 
FORTRAN lV 
COBOL 

RPG il 


Library module 
reading 
writing 


Line length, setting and changing 


Line mode 
entering from screen mode 
explanation 
specifying 


Line numbers 


Line-range, description 


@LIST command 
examples 
explanation 
format 
help screen 
used with modifiers 
used with other commands 


Listing module names and types 


Loading and executing a procedure file 


Locating data 


Log-on procedure 


Index 6 


Reference Page 


1.3 l-/ 
19 7-13 
10.2.4 10-6 
10.2.4 10-6 
10.2.4 10-6 
10.2.4 10-6 
10.2.4 10-6 
3.14 3-32 
3.18 3-58 
7.9 7-10 
10.3.5 10-24 
1.2.1 ]-4 
7.9 7-13 
See work-space 
line numbers. 

1.3 1-8 
3.9 3-21 
3.9 3-2 
3.9 3-20 
3.9 3-2 
3.9 3- 
3.9 3-21 
See @FSTATUS 
command. 

55 5-8 
5.9 5-13 
See @FIND 
command. 

2.1 2-1 
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} Term 


MIRAM library module or data file 
reading 
writing 


Mode, specifying 


Modifiers 


@MOVE command 
examples 
explanation 
format 
help screen 
used with modifiers 
used with other commands 


Moving data 


Multiple line entry 


Multiple source modules, FORTRAN IV 


Reference 


3.14 
3.18 


10.1 
10.2.2 
78 


310 
3.10 
3.10 
3.10 
3.10 
3.10 


See @MOVE 
command. 
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10.1 
10.2.3 
10.2.1 
10.3.2 
10.3.2.1 
10.3.2.2 
10.3.2.3 
10.3.2.4 
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7-13 
10-1 
10-4 
10-3 
10-16 
10-17 
10-18 
10-19 
10-20 


11-6 


Term 


@NOP command 
example 
explanation 
format 
help screen 


NOPRINT option 


NOT modifier 
examples 
explanation 


@NUMBER command 
examples 
explanation 
format 
help screen 
used with modifiers 
used with other commands 


ON modifier 
examples 
explanation 


Overwriting a file 


Index 7 


Reference Page 


46 
46 


3.11 
3.11 
3.11 
3.11 
3.1] 
3.11 


4] 
4] 
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Term 


@PARAMS screen command 
example 
explanation 
format 
function key equivalent 


help screen 


Password, description 


Placing sequence numbers into 
existing lines 


@PRINT command 
examples 
explanation 
format 
help screen 
screen mode 
use with modifiers 


use with other commands 


PRINT option 


Printing data 


@PROC command 
examples 
explanation 
format 
help screen 


Procedure files 


Processing loop 


Program unit 


@PROMPT screen command 
examples 
explanation 
format 
function key equivalent 


help screen 


Prompt help screen 


Reference 


8.4 
8.4 
8.4 
8.4 
Section 9 
8.4 


3.14 
3.18 


3.16 


312 
3.12 
ce 
3.12 
10.3.4 
3.12 
3.12 


2 
a) 


See @LIST 


command. 


“i 
9.7 
D1 
Oe 


See EDT 
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@PUNCH command 


examples 
explanation 
8-8 format 
8-7 help screen 
8-7 used with modifiers 
8-7 used with other commands 
8-7 Punching data 
3-34 
3-60 
3-52 
3-28 Q 
3-27 
3-27 Quotation marks, use 
3-2] 
10-22 
3-29 
3-29 
5-3 
5-8 
R 

Range separator, changing 

@READ command 
d-1l explanation 
9-11 help screen 
ae positional parameters 


used with other commands 


Reading data 


procedure files. 


Appendix B 


ie eal 
L324 
IES 


8.5 
8.5 
8.5 
8.5 
Section 9 
8.5 


8.5 


Reading to the current work-space file 
a file from a tape 


i a file from a sequential device 
a“ a file from the spool file 
: MIRAM program library or data file 
on disk or diskette 
SAT or MIRAM library module on disk 
8-9 or diskette 
8-9 
ae RECENTRY 
8- specifying 
8-9 
effect on EDT screen displays 
8-9 


Index 8 


Reference 


3.13 
3.13 
3.13 
3.13 
3.13 
3.13 


See @PUNCH 
command. 


78 


3.14 
3.14 


Appendix E 


3.14 


See @READ 


command. 


3.14 
3.14 
3.14 


3.14 


3.14 


19 
10.2.3 
10.3.2.1 
10.3.2.2 
10.3.2.3 
10.3.2.4 


7-11 


3-35 


3-33 


eal 
10-4 
10-17 
10-18 
10-19 
10-20 











UP-8828 Rev. 2 SPERRY UNIVAC OS/3 Index 9 
GENERAL EDITOR (EDT) 
Term Reference Page Term Reference Page 
Record size 
changing record size 19 -}] 
setting record size 7.9 7-11 SAT library modules 
reading 3.14 3-32 
Relational operators 6.4 6-7 writing 3.18 3-58 
@REMOVE command Saving an EDT procedure file 59 5-12 
examples sa he) 3-50 
explanation 3.15 3-50 Saving data/tile See @WRITE 
format 3.15 3-50 command. 
help screen 3.15 3-50 
used with other commands 3.15 3-51 SCRDSPLY 1.9 7-12 
8.2 8-3 
@RESTORE screen command 8./ 8-14 
explanation 8.6 -13 10.2.1 10-3 
format 8.6 8-13 
function key equivalent 8.6 -13 Screen commands 
Section 9 explanations Section 8 
help screen 86 8-13 use in screen mode 10.1 10-1 
use with EDT commands 3.1 3-1 
@RETURN command 
explanation 5.8 5-12 Screen mode 
format 5 8 Bh beginning screen mode 10.3.1 10-14 
help screen 5.8 5-12 considerations 10.3.2 10-16 
displaying EDT’s work-space 
REVERT option 5.2 5-3 contents 10.3.4 10-22 
5.5 5-8 ending 10.3.5 10-24 
entering EDT commands 10.3.3 10-21 
@ROLL screen command entering source code or data 10.3.2 10-15 
entering in screen mode 10.3.4 10-22 explanation 1.2.2 1-5 
example 8.7 8-15 specifying 7.9 7-13 
explanation 87 8-14 terminating EDT from 
format 8.] 8-14 Screen mode 10.3.5 10-24 
function key equivalent 8.7 8-14 
Section 9 SCRFORM 7.9 7-13 
help screen 8.7 8-14 10.2.5 10-7 
10.3.2.1 10-17 
@RPG directive 
explanation 7.8 7-8 Search string 1.3 1-8 
format 7.8 7-8 
help screen 78 7-8 Search text, displaying errors 11.3.2.2 11-7 
RPG Wl editor 7.8 7-8 @SEQUENCE command 
10.1 10-1 examples 3.16 3-53 
explanation 3.16 3-52 
RPG Il screens format 3.16 3-52 
CONTROL-field 10.2.4 10-7 help screen 3.16 3-52 
FORM field 10.2.4 10-7 used with modifiers 3.16 3-53 
PAGE-LINE field 10.2.4 10-7 used with other commands 3.16 3-53 
preset fields and tabs 10.2.4 10-6 
PROGRAM-ID field 10.2.4 10-7 Sequence numbers 
samples 10.2.6.1 10-8 inserting into existing lines 3.16 3-52 
screen mode 79 7249 inserting into input lines 3.11 3-25 
10.2.4 10-7 
10.] 10-1 Sequence-string 1.3 1-8 
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Term 


@SET directive 


defining exclusion character 


examples 
explanation 

format 

help screen 
Setting buffer size 
Setting device size 
setting end-column 
Setting line length 


setting range separator 


setting tab character 
setting tab stops 


Setting trigger character 


Single line entry 


SHOW modifier 
examples 
explanation 
Special symbols 
Start-of-entry symbol 
Storage space, allocating 


String 


String multiplication factor 


@SYSTEM directive 
examples 
explanation 
format 
help screen 


Reference 


19 
10.1 
10.2.3 
10.2.1 
10.3.2 


48 
4.8 


Ls 


2.1 


1.3 


3.3 
3.4 
35 
3.6 
3.8 
39 
3.10 
3.11 
3.12 
3.13 
3.19 
3.16 
3.1/ 


6.3 


7.10 
110 
7.10 
7.10 
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7-10 
7-14 Tab character 
7-9 changing 
7-9 setting 
/-9 
7-11 TABS 
7-12 changing tab stops 
7-11 Setting tab stops 
7-10 
/-11 Terminating EDT 
7-9 permanently 
7-9 
7-11 temporarily 
7-13 
10-1 Terminating EDT from screen mode 
10-4 
10-3 Terminating EFP 
10-15 

Terminating procedure file definition 
4-9 
4-9 Terminating procedure file execution 
1-9 

TO modifier 
2-2 examples 

explanation 

3-58 

Transferring data 
1-8 


command trigger 


i ( ] } | 
moo Oom™ Th DW wow re 


a Tc Rh en i Ge Tac ta a al es 
ma ho Oo On OM & RO HM RO Mh RR Re OO Om 


Transmitting data to the work-space file 


Trigger-character, changing 


Index 10 


Reference Page 


19 1-9 
1.9 1-9 


19 ]- 
19 / 


23 2-] 
7] /-] 
2.3 2-] 
7.10 /-1 
10.3.5 10-24 
11.3.2.3 11-10 


see @END 
command. 


See @RETURN 


command. 

49 4-10 
4g 4-10 
See @MOVE 
command. 

2.1 2-1 
79 7-11 
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U 
Underline as input prompt character 10.2.5 10-7 
10.3.2 10-16 
10.3.3 10-21 
@UPDATE command 
@CONTINUE command gt 3-55 
examples 3.17 3-56 
explanation 37 3-54 
format 3.17 3-54 
help screen 3.17 3-54 
@NOCHANGE command ney, 3-99 
@STRIKE command 3.17 3-55 
Update options 
@CONTINUE 3.17 3-55 
@NOCHANGE 3.17 3-55 
@STRIKE 3.17 3-55 
Updating data See @UPDATE 
command. 
Updating in screen mode 
@ data file or assembler module 10.3.2.1 10-17 
FORTRAN IV source module 10.3.2.2 10-18 
COBOL source module 10.3.2.3 10-19 
RPG Il source module 10.3.2.4 10-20 
Updating, sample sessions Appendix G 
V 
Variables See EDT 
variables. 
Viewing and updating lines 8.7 8-14 


Term 


Work-space file | 
deleting 
description 


Work-space line numbers 
changing/setting 
description 
use 


Workstation 
function keys 
logging on 


Workstation commands 


@WRITE command 
explanation 
help screen 
positional parameters 
used with other commands 


Writing the current work-space file 

to a MIRAM program library or data 
file on disk or diskette 

to a SAT or MIRAM library module on 
disk or diskette 

to a sequential device file 

to a spool file 

to a tape 
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74 
1.2 
Fig. l- 
Fig. 1 
5.1 

Fig. 5-1 


a2 
Liz 
LZ 


Section 9 
2.1 


7.10 


3.18 
3.18 
Appendix £ 
3.18 


3.18 


3.18 
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3.18 
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